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PREFACE 


This manual is written for those who configure an IBM host to 
Support connection with the DPS 6 Systems Network Architecture | 
(SNA) program products: 


SNA Interactive Terminal Facility (ITF) 
SNA Remote Job Entry (RJE) Facility 

SNA File Transfer Facility (SFT) 

SNA Application Interface Facility (AIF). 


The main topics discussed in this manual are: 


Introduction (Section 1) 

Network considerations (Section 2) 

ACF/NCP generation (Section 3) 

ACF/VTAM definition (Section 4) 

Defining ITF to interactive systems (Section 5) 
Defining the RJE Facility to JES2 (Section 6) 
Installing SFT on the host (Section 7) | 
Defining AIF to interactive systems (Section 8) 
Use of SNA with NCCF and NPDA (Section 9) 
Configuration worksheets (Appendix A). 


| This manual does not discuss configuring the host system 
beyond SNA considerations. This manual does not discuss the 
configuration of SNA networks in general; it only discusses those 
characteristics required by DPS 6 SNA on the host system. 


This manual assumes that the IBM host operating system is 
MVS. For information concerning DOS, contact your Honeywell 
representative. 


USER COMMENTS FORMS are included at the back of this manual. These forms are to be used to record 
any corrections, changes, or additions that will make this manual more useful. 


Honeywell disclaims the implied warranties of merchantability and fitness for a particular 
purpose and makes no express warranties except as may be stated in its written agreement 
with and for its customer. In no event is Honeywell liable to anyone for any indirect, special 
or consequential damages. 

The information and specifications in this document are subject to change without notice. 
Consult your Honeywell Marketing Representative for product or service availability. 
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This manual does not contain configuration information for 
the DPS 6; the DPS 6/SNA Administrator's Guide contains that 
configuration information. 


In this manual, the term "DPS 6" refers to DPS 6, disk-based 


microSystem 6/10, or microSystem 6/20 systems, unless otherwise 
noted. 


The following symbols are used in this manual: 


e Uppercase letters (for example, LISTHST) indicate commands 
or directives that you must reproduce exactly as shown. 


® Lowercase letters (for example, lu_name) indicate a 
symbolic variable whose exact value you must supply. 


@® Braces {} enclose items from which you must make a 
choice. The valid choices are on separate lines. 


The following conventions are used to indicate the relative 
levels of topic headings used in this manual: 


Level Heading Format 

1 (highest) ALL CAPITAL LETTERS, UNDERLINED 

2 Initial Capital Letters, Underlined 

3 ALL CAPITAL LETTERS, NOT UNDERLINED 

4 Initial Capital Letters, Not Underlined 
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MANUAL DIRECTORY 


Manuals are obtained by submitting a Honeywell Publications 
Order Form to the following address: 


SNA MANUALS 


Honeywell Information Systems Inc. 
47 Harvard Street 
Westwood, MA 02090 


Attn: Publications Services MA06-01 


The following publications constitute the DPS 6/SNA manual 
set for Release 1.2 of SNA. | 


Order Number 


CR56 
CR57 
CR58 
CR5 9 
CR60 
GRI1l 
C274 


GB88 


Manual Title 


IBM Distributed Data Processing Overview 

DPS 6 SNA Administrator's Guide 

SNA Interactive Terminal Facility User's Guide 

SNA Remote Job Entry Facility User's Guide 

SNA File Transfer Facility User's Guide 

SNA Application Programmer's Guide 

GCOS 6 Data Base Augmented Real-Time Tracing 
System User's Guide 

SNA Host System Programmer's Guide 


SOFTWARE RELEASE BULLETIN 


The SNA product is described in a Software Release Bulletin. 
Consult the Software Release Bulletin before using the software. 
The DPS 6/SNA Software Release Bulletin is: 


Order Number 


GR12-00 


SRB Title 


GCOS 6 SNA Software Release Bulletin 
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MOD 400 MANUALS 


The MOD 400 manual set provides information prerequisite to 
using the SNA manual set. Honeywell software reference manuals 
are periodically updated to support enhancements and improvements 
to the software. Before ordering any manuals, refer to the 
Manual Directory of the MOD 400 Guide to Software Documentation 
to obtain information concerning the specific edition of the 
manual that supports the software currently in use at your 
installation. If you use the four-character base publication 
number to order a document, you will receive the latest edition 
of the manual. If you wish to order a specific edition of 
document, you must use the seven- or eight-character publication 
number listed in the MOD 400 Guide to Software Documentation, 


IBM MANUALS 


Refer to these IBM documents for host programming, operating, 
application, and configuration information: 


Order Number Manual Title 


SC27-0164 ACF/VTAM Messages and Codes 

SC27-0449 ACF/VTAM Programming 

SC27-0611 ACF/VTAM Planning and Installation Reference 

SC30-3167 ACF/NCP Installation and Resource Definition 

SC30-3168 ACF/NCP System Support Programs: Utilities 

SC30-3169 ACF/NCP and Emulation Program: Messages and 
Codes 

SC33-0149 CICS Resource Definition Guide 

SC23-00 46 JES2 Initialization and Tuning 
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| Section 1 
INTRODUCTION 


The DPS 6 is a general-purpose computer that can run a 
variety of applications--word processing, data entry, transaction 
processing, program development, etc.--and, at the same time, 
communicate with an IBM host computer. 

DPS 6 COMMUNICATIONS WITH IBM HOST PROCESSORS 

GCOS 6 MOD 400, the operating system for the DPS 6, Supports 
a number of Systems Network Architecture (SNA) communications 
software products. It also supports software products that 
emulate widely used IBM Binary Synchronous Communication (BSC) 
communications devices. Both SNA and BSC facilities can operate 
concurrently on the DPS 6 if desired. 

The SNA products are: 


® SNA Transport Facility (prerequisite for other SNA 
products) 


e SNA Interactive Terminal Facility (SNA 3270 emulation) 
® SNA Remote Job Entry Facility 
e® SNA File Transfer Facility 


@® SNA Application Interface Facility. 
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For more information on the DPS 6 SNA products, see these 
manuals: 


IBM Distributed Data Processing Overview 

DPS 6 SNA Administrator's Guide 

SNA Interactive Terminal Facility User's Guide 
SNA Remote Job Entry Facility User's Guide 
SNA File Transfer Facility User's Guide 

SNA Application Programmer's Guide 


The BSC products are: 


e BSC Transport Facility (prerequisite for other BSC 
products) 


e 2780/3780 Workstation Facility 
@e HASP Workstation Facility 
@e Programmable Facility/3271 (BSC 3270 emulation) 


For more information on the DPS 6 BSC products, see these 
manuals: 


2780/3780 File Transmission Facility User's Guide 
2780/3780 Workstation Facility User's Guide 

HASP Workstation Facility User's Guide 
Programmable Facility/3271 User's Guide 


PURPOSE AND STRUCTURE OF THIS MANUAL 


This manual is intended to provide all of the information 
that a systems programmer needs to configure the IBM host 
hardware and software correctly for the DPS 6 SNA products. 


This manual consists of the following sections: 
1. Introduction--Overview and contents of this manual. 


2. Network Considerations--This section discusses general 
characteristics of the DPS 6 SNA products to consider 
when designing an SNA network to include DPS 6 systems. 


3. ACF/NCP Generation--This section describes the Advanced 
Communications Function/Network Control Program (ACF/NCP) 
generation statements required for the DPS 6 SNA 
products. 


4. ACF/VTAM Definition--This section describes the Advanced 
Communications Function/Virtual Telecommunications Access 
Method (ACF/VTAM) definition statements required for the 
DPS 6 SNA products. | 
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5. Defining the ITF to Interactive Systems--This section 
describes the IBM 3270 features Supported by ITF and 
discusses how to define ITF to the IBM subsystems 
Customer Information Control System (CICS) and 
Information Management System (IMS). 


6. Defining the RJE Facility to Job Entry Subsystems--This 
section discusses how to define the RJE Facility for the 
IBM Job Entry Subsystem JES2. 


7. Installing the SFT on the Host--This section lists the 
Job Control Language (JCL) needed to install the SFT (as 
reference only; JCL is included on the SFT installation 
tape). 


8. Defining the AIF to Interactive Systems--This section 
discusses how to define the AIF to the IBM subsystems 
CICS and IMS. 


9. Use with NCCF and NPDA--This section describes how the 
IBM network problem determination products NCCF and NPDA 
can be used to analyze SNA statistics from the DPS 6 SNA 
products. 


10. Configuration Worksheets--The appendix provides 
Configuration Worksheets that highlight the configuration 
parameters that are common to both the IBM host 
generation and the DPS 6 SNA product configuration. 


The network administrator or network designer should use this 
manual to fill out the Configuration Worksheets in Appendix A and 
give the worksheets to those responsible for configuring the 
DPS 6 system and generating the IBM host software. The 
Configuration Worksheets ensure that all relevant parameters have 
been considered and that the configuration of the DPS 6 SNA 
products and the host software agree. 
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Section 2 
NETWORK 
CONSIDERATIONS 


This section discusses general characteristics of the DPS 6 
SNA products to consider when designing an SNA network to include 
DPS 6 systems. 


Later sections discuss in detail how to customize the SNA 
software for the DPS 6. 


HOW SNA PROGRAM PRODUCTS ARE VIEWED BY THE HOST 


The DPS 6 SNA Interactive Terminal Facility (ITF) appears to 
the host as an IBM 3274-1C (or -51C) Terminal Controller. The 
DPS 6 terminals supported by the ITF appear to be IBM 3278 Model 
2 Display Stations. The Honeywell printers supported by the ITF 
appear to be IBM 3287 Model 2 Printers. 


The DPS 6 SNA Remote Job Entry (RJE) Facility appears to the 
host as an IBM 3777 Model 3 Remote Job Entry Workstation with 
attached readers, printers, punches, and diskettes. 


The DPS 6 SNA File Transfer Facility (SFT-6) and SNA 


Application Interface Facility (AIF) products do not emulate IBM 
products, but instead appear to the host as general SNA devices. 
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The number of devices that one copy of the ITF or the RJE 
Facility can support cannot be greater than the number supported 
by the IBM product it emulates. Even though the SFT-6 and the 
AIF do not emulate IBM products, there is still a limit on the 
number of concurrent file transfers or application sessions. The 
limits for one copy of each of the SNA products are: 


ITF: 32 displays and printers (combined) 
RJE Facility: 6 input and output devices (combined) 
SFT-6: 6 file transfers 
AIF: 33 LU Type 0 sessions. 


However, this limitation on the number of devices that one 
copy of an SNA product can support does not limit the number of 
devices the DPS 6 can Support. You can execute several copies of 
each of the SNA products at once, with each copy supporting the 
maximum number of devices. The number of copies of the SNA 
products that you can run concurrently is limited only by SNA 
limits and DPS 6 resources (CPU, memory, etc.). 


In SNA terminology each of the SNA products acts as a 
Physical Unit Type 2 (PU.T2) or Cluster Controller. Each copy of 
the ITF, the RJE Facility, the SFT-6, or the AIF appears to the 
host aS a separate physical unit. For example, a DPS 6 running 
two copies of the ITF, one copy of the RJE Facility, one copy of 
the AIF, and one copy of the SFT-6 would appear to the host as 
five SNA physical units. 


No matter how many SNA devices a DPS 6 appears to be to the 
host, the DPS 6 needs only one communications line connection 
(with only one modem). If necessary, however, the SNA products 
can support up to four communications lines. One copy of the 
ITF, the RJE Facility, the SFT-6, or the AIF supports a single 
communications line, so that multiple lines would require 
multiple copies. | | 


The DPS 6 SNA products can communicate with multiple hosts, 
either by means of separate communications lines to the different 
hosts or through the MultiSystem Networking Feature (MSNF) of 
ACF/NCP and ACF/VTAM. 


COMMUNICATIONS LINE CHARACTERISTICS 


The DPS 6 SNA products support the following types of SDLC 
communications lines: 


@ Half- ~duplex and full-dupl ex 


@ Point-to-point and multipoint 
@e Switched and nonswitched. 
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If your modems and communication line will support it, it can 
be beneficial to define a multipoint line as full-duplex even 
though the DPS 6 SNA products, like all similar IBM products, can 
Only run in half-duplex mode. On a full-duplex line, one 
half-duplex device can be sending while other half-duplex devices 
are receiving. This type of line operation is sometimes called 
multimultipoint. 


The DPS 6 Supports all standard (RS-232C interface) modems at 


line speeds up to 56K bits per second. If it has the appropriate 
communications hardware, the DPS 6 will support NRZI. 
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Section 3 
ACF/NCP GENERATION 


This section discusses how to code the ACF/NCP generation 
macros for the DPS 6 SNA products. The discussion covers only 
the macros needed for the DPS 6 (GROUP, LINE, LUPOOL or LUDRPOOL, 
PU, and LU). Further, not all macro operands are discussed-- 
only those that depend on the characteristics of the DPS 6 SNA 
products or the way those products are configured. See the 
appropriate IBM documentation for a discussion of the other 
aspects of ACF/NCP generation. 


The DPS 6 configuration and ACF/NCP generation must agree 
about certain characteristics of the communications connection 
between them. The Configuration Worksheets in the appendix 
should be used to ensure that the same values are given to both. 


At the end of this section are samples of the relevant parts 
of ACF/NCP generations for nonswitched and switched line 
configurations. The related ACF/VTAM switched line definition 
statements are discussed in the next section. : 

ACF/NCP generation macro-operands are discussed with the 
lowest level macro to which they apply. See the ACF/NCP 
installation documentation for information on which operands can 
be specified on higher level macros. 
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The ACF/NCP generation macros are discussed in the order they 
would be coded for a new line group for SNA DPS 6 systems: 


ep tet 


Figure 3-1 contains a partial sample NCP generation for DPS 6 
SNA for a nonswitched line; Figure 3-2 contains a partial sample 
NCP generation for DPS 6 SNA for a switched line. 
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* 


NON-SWITCHED LINE EXAMPLE 


LGRP GROUP DIAL=NO, 


* 
LLINE LINE 


* 


DISCNT=NO, 
ISTATUS=INACTIVE, 
LNCTL=SDLC, 
MODETAB=ISTINCLM, 
NRZI=NO, 
REPLYTO=1.2, 
SSCPFM=USSSCS, 
TYPE=NCP, 
USSTAB=ISTINCDT, 
VPACING=2 


ADDRESS=(020), 
CLOCKNG=EXT, 
DUPLEX=FULL, 
SPEED=9600, 
INTPRI=2, 
NEWS YNC=NO, 
PAUSE=0 .2, 
POLLED=YES, 
RETRIES=5, 
SERVLIM=5, 
TRANSFR=9 


SAMPLE NCP GENERATION (PARTIAL) FOR DPS 6 SNA 


NON-SWITCHED LINE 


DON'T DISC. WHEN NO SESSIONS 
DON'T ACTIVATE WHEN ACT VTAM 


SDLC LINE GROUP 

DEFAULT LOGON MODE TABLE 
DON'T USE NRZI 

TIMEOUT IF NO REPLY IN 1.2 
CHARACTER CODED LOGONS 
NETWORK CONTROL MODE 

USE IBM-SUPPLIED USS TABLE 
DEFAULT VTAM-TO-NCP PACING 


INTERFACE ADDRESS 

MODEM PROVIDES CLOCKING 
FULL DUPLEX LINE 

9600 BITS PER SECOND 
INTERRUPT PRIORITY 
DON'T SUPPLY NEWSYNC 
AVERAGE POLLING CYCLE | 
POLL STATIONS ON LINK 

5 RETRIES IN SEQUENCE 
MAXIMUM REGULAR SCANS 

9 BUFFERS TO ONE STATION 


LSRVC SERVICE ORDER=(L3274PU,L3277PU,LSFTPU) 
rig 


¥ DEFINITION OF INTERACTIVE TERMINAL FACILITY 


* 
L3274PU PU 


Figure 3-l. 


ADDR=01, 
DLOGMOD=H3278, 
IRETRY=YES, 
MAXDATA= 265, 
MAXOUT=7 ’ 
PACING=1, 
PASSLIM=11, 
PUTYPE=2, 
RETRIES=(,1,4) , 
VPACING=1 


PU ADDRESS 


SET DEFAULT LOGON MODE (DISPLAY) 
RETRY POLLING AFTER IDLE T.O. 


MAXIMUM PIU SIZE 


MAXIMUM PIU'S BEFORE RESPONSE 


NCP-TO-LU PACING 
MAXIMUM CONSECUTIVE PIU'S 


PU TYPE 2 (CLUSTER CONTROLLER) 


M=64, T=1 SEC., N=4 SEC. 
VTAM-TO-NCP PACING 


* 
* 
* 
* 
* 
* 


SEC 


OE OS OS OS OS OS OK DS OS OOS 


PS PS OS OS OS OM OX OS OS 


PS PS OS OS OS OS DS OS DS 


Sample NCP Generation for a Nonswitched Line 
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INTLUL LU LOCADDR=2 DISPLAY 1 LOCAL ADDRESS 


INTLU2 LU LC CADDR=3. DISPLAY 2 LOCAL ADDRESS 

INTLU3 LU LOCADDR=4 DISPLAY 3 LOCAL ADDRESS 

INTLU4 LU LOCADDR=5 DISPLAY 4 LOCAL. ADDRESS 

INTLUS LU LOCADDR=6, 3270 PRINTER LOCAL ADDRESS X 
DLOGMOD=H3 287 SET PRINTER LOGON MODE DEFAULT 

INTLU6 LU LOCADDR=7, SCS PRINTER LOCAL ADDRESS X 
DLOGMOD=HSCS SET PRINTER LOGON MODE DEFAULT 

* 

* DEFINITION OF REMOTE JOB ENTRY FACILITY 3777 

* 

L3777PU PU ADDR=02, PU ADDRESS X 
BATCH=YES, USE BATCH PRIORITY X 
DLOGMOD=BATCH, DEFAULT LOGON MODE (RJE FAC) X 
IRETRY=YES, RETRY POLLING AFTER IDLE T.O. X 
MAXDATA=521, MAXIMUM PIU SIZE X 
MAXOUT=7, MAXIMUM PIU'S BEFORE RESPONSE Xx 
PACING=(1,1), NCP-TO-LU PACING X 
PASSLIM=7, MAXIMUM CONSECUTIVE PIU'S Xx 
PUTYPE=2, PU TYPE 2 (CLUSTER CONTROLLER) X 
RETRIES=(,1,5), M=64, T=l1 SEC., N=5 SEC. X 
VPACING=2 VTAM-TO-NCP PACING 

* 

RJELUL LU LOCADDR=1 

RJELU2 LU LOCADDR=2 

RJELU3 LU LOCADDR=3 

RJELU4 LU LOCADDR=4 

RJELUS LU LOCADDR=5 

RJ ELU6 LU LOCADDR=6 

* 

* DEFINITION OF FILE TRANSFER 

* | 

LSFTPU PU i ADDR=03, PU ADDRESS X 
BATCH=YES, USE BATCH PRIORITY X 
DLOGMOD=FILETRAN, SET DEFAULT LOGON MODE X 
IRETRY=YES, RETRY POLLING AFTER IDLE T.O. xX 
MAXDATA=265, MAXIMUM PIU SIZE X 
MAXOUT=7, MAXIMUM PIU'S BEFORE RESPONSE X 
PACING=(4,1), NCP-TO-LU PACING Xx 
PASSLIM=7, MAXIMUM CONSECUTIVE PIU'S X 
PUTYPE=2, PU TYPE 2 (CLUSTER CONTROLLER) X 


VPACING=8 VTAM-TO-~NCP PACING 
* | 


FTLU1 LU LOCADDR=1 
FTLU2 LU LOCADDR=2 


Figure 3-1 (cont). Sample NCP Generation for a Nonswitched 
| Line 
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* * 

* SAMPLE NCP GENERATION (PARTIAL) FOR DPS 6 SNA * 

* * 

* SWITCHED LINE EXAMPLE * 

* * 

KKEKEKEKEKKKEKEKKKKEEKEKEEKREKKEEEKKEKKEKKKEKKEKAKEEKKKEEKKEEKREKEEKERKERKKKKRKKRKRKK KEK 

‘ | 

SWLUPOOL LUPOOL 

* 

SWGRP = GROUP DIAL=YES, SWITCHED LINE X 
ANSWER=ON, REMOTES CAN DIAL IN X 
CALL=INOUT, DIAL-IN AND DIAL-OUT X 
ISTATUS=INACTIVE, DON'T ACTIVATE WHEN ACT VTAM X 
LNCTL=SDLC, | SDLC LINE GROUP X 
MODETAB=ISTINCLM, DEFAULT LOGON MODE TABLE xX 
NRZI=NO, DON'T USE NRZI X 
REPLYTO=NONE, DON'T TIMEOUT X 
SPEED=2400, ~ 2400 BITS PER SECOND X 
SSCPFM=USSSCS, CHARACTER CODED LOGONS x 
TYPE=NCP, NETWORK CONTROL MODE X 
USSTAB=ISTINCDT USE IBM-SUPPLIED USS TABLE 

* 

SWLINE LINE ADDRESS=(030), INTERFACE ADDRESS X 
CLOCKNG=EXT, MODEM PROVIDES CLOCKING X 
DUPLEX=HALF, HALF DUPLEX LINE X 
INTPRI=2, INTERRUPT PRIORITY X 
PAUSE=0.2, AVERAGE POLLING CYCLE X 
POLLED=YES, POLL STATIONS ON LINK X 
RETRIES=5, 5 RETRIES IN SEQUENCE X 
SERVLIM=5, MAXIMUM REGULAR SCANS X 
TRANSFR=9 | 9 BUFFERS TO ONE STATION 

* 

SWPU PU PUTYPE=2, PU TYPE 2 X 
MAX LU=6 ALLOW UP TO 6 LU'S 


Figure 3-2. Sample NCP Generation for a Switched Line 
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LUPOOL OR LUDRPOOL MACRO 
One of these macros is required for switched lines. If the 
host system supports the Request Network Address Assignment 
command, then the LUDRPOOL macro is required. If the host system 
does not support the command, then the LUPOOL macro is required. 
The format of the LUDRPOOL macro is: 
LUDRPOOL NUMTYP2=n 


NUMTYP2=n This is the number of logical units (type 2) in 
the pool. 


For the LUPOOL macro, the operand that must be coded for the 
DPS 6 SNA products is: 


LUPOOL NUMBER=n 


NUMBER=n This is the number of logical units in the pool. 
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GROUP MACRO 


The GROUP macro is the start of the definition of a group of 
lines and devices that have common characteristics. 


The operands that must be coded on the GROUP macro used to 
begin definition of a line group that includes DPS 6 systems are: 


GROUP DIAL= ee 
v 


NO 
LNCTL=SDLC, 
TYPE=NCP, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. | 


aia The DPS 6 supports both switched and nonswitched 

NO lines. This value is referred to as LINE in the 
Configuration Worksheets. This operand must agree 
with a corresponding operand in the DPS 6 
configuration. 


LNCTL=SDLC The DPS 6 SNA products Support only SDLC lines. 


TYPE=NCP SDLC lines must be in Network Control Mode. 
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LINE MACRO 


The LINE macro describes the characteristics of a 
communications line.  — | 


The operands that must be coded for a jine that Supports 
DPS 6 systems are: 


LINE DUPLEX= ee | 
FULLS , 
NRZ I= {xES\ 
v 


POLLED=YES, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. | 


DU PLEX= fat The DPS 6 supports both half-duplex and 


FULL full-duplex lines. 
NRZ I= Pog The DPS 6, when equipped with the 
NO 


appropriate communications controller, 
Supports NRZI. | 


POLLED= YES The SDLC line must be polled and addressed 
by the host. 
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PU MACRO (FOR NONSWITCHED LINES) 


The PU macro defines the characteristics of the DPS 6 SNA 
Interactive Terminal Facility (ITF), SNA Remote Job Entry (RJE) 
Facility, SNA File Transfer Facility (SFT-6), or SNA Application 
Interface Facility (AIF) physical unit. This ACF/NCP macro is 
used only for DPS 6 systems attached to nonswitched lines. For 
switched lines, see the PU statement under "ACF/VTAM Definition." 


The operands that must be coded for the DPS 6 SNA products 
are: 


PU ADDR=nn, 


PUTYPE=2, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


ADDR=nn The station address is a hexadecimal number 
in the range X'01'-X'FE', It must agree 
with a corresponding parameter in the ITF, 
RJE Facility, SFT-6, or AIF configuration. 


MAXDATA= erty, This is the largest SDLC frame that can be 
521 sent to the DPS 6 is the size of the largest 

buffer (256 or 512 bytes) plus 9 bytes of 
SNA header information. This value is 
referred to as MAX FRAME SIZE in the 
Configuration Worksheets. This operand must 
agree with a corresponding parameter in the 
ITF, RIE, SFT-6, or AIF configuration. The 
values that you code depend on the product: 


ITF: 265 
RJE Facility: 265 or 521 
AIF: 265 or 521 E 


SFT-6: 265 or 521 


PUTYPE=2 All of the DPS 6 SNA products are SNA 
| physical units type 2. 
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LU_MACRO 


The Logical Unit (LU) macro describes the characteristics of 
an ITF, RJE Facility, SFT-6, or AIF logical unit. 


The operands that must be coded for the DPS 6 SNA products 
are: | 


LU LOCADDR=n, 


SSCPFM=USSSCS, (VTAM-only) 


Operands that are not required but for which recommendations 
can be made are: | 


DLOGMOD=logmode (VTAM-only) 
PACING=n (VTAM-only) 
VPACING=n (VTAM- only) 


You will probably need other Operands, but these are the ones 
that are most important for the DPS 6. 


The VTAM-only operands are discussed under "ACF/VTAM 
Definition," | 


LOCADDR=n The local address of the ITF, RJE Facility, 
AIF, or SFT-6 logical unit must agree with a 
corresponding parameter in the ITF, RJE, AIF, 
or SFT-6 configuration. This value is referred 
to as LU ADDRESS in the Configuration 
Worksheets. The values allowed depend on the 
product: 


ITF: 2 to 33 
RJE Facility: 1 to 6 
- AIF: 2 to 33 
SFT-6: 1 to 6 
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Section 4 
ACF/VTAM DEFINITION 


This section discusses how to code the Advanced Communi- 
cations Function/Virtual Telecommunications Access Method 
(ACF/VTAM) generation statements for the DPS 6 SNA products. 
Four aspects of ACF/VTAM generation are relevant to the DPS 6: 


® VTAM-only operands of Network Control Program (NCP) 
Network Configuration macros 


@ ACF/VTAM statements for SNA devices connected by switched 
lines 


@e ACF/VTAM statement for SNA applications 


@® Logon mode table entries for the SNA Logical Units. 


VTAM-ONLY OPERANDS IN NCP GENERATION MACROS 


The ACF/NCP generation macros are also interpreted by 
ACF/VTAM so that it knows the structure of the SNA network. For 
convenience, the ACF/NCP network configuration macro-instructions 
GROUP, LINE, PU, and LU can have VTAM-only operands that are 


checked but not used by NCP. This section discusses how to code 
these operands. 


The sample ACF/NCP generations at the end of Section 3 
contain examples of the coding of these operands. 
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The only operand that 
products is: 


SSCPFM=USSSCS 


Operands that are not 
can be made are: 


must be coded for the DPS 6 SNA 


required but for which recommendations 


DLOGMOD=1logmode 


PACING=n 
V PACING=n 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


SSCPFM=USSSCS The DPS 6 SNA products only support 
character-coded logons. 


- DLOGMOD=logmode Depends on the product; see "Logon Mode Table 
Definitions" in this section. 


PACING=n The SNA products will adapt to the PACING 
parameters specified in the VTAM generation. 
Some things to take into account when 
deciding on the NCP-to-LU pacing are: 


ITF: 


Because a 3270 can only accept one 
screen's worth of information at a 
time, the host software will never send 
more than that before waiting for a 
response. Nevertheless, an ITF LU 
should be coded with: 


PACING=1 


which means that every request unit 
sent to the LU is confirmed with a 
pacing response. 


For ITF printer LUs, use a pacing value 
higher than 1. A pacing value of 4 is 
common. 


RJE Facility, SFT-6, and AIF: 


Because LUS for these products 
typically receive long streams of data, 
they can benefit from large pacing © 
values. The determining factor is how 
much space you wish to devote to 
buffered data on the DPS 6. 
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VPACING=n 


The main thing to take into account when 
deciding on the VTAM-to-NCP pacing parameter 
is its affect on the VTAM and NCP buffer 


pools: 


ITF: Because a 


3270 can only accept one 


screen's worth of information at a 


time, the 
more than 
response. 
should be 


VPACING=1 
which means that VTAM will send NCP any 
information for the LU and then receive 
a pacing response. 


RJE Facility, SFT-6, and AIF: 


host software will never send 
that before waiting for a 

Nevertheless, an ITF LU 
coded with: 


Because LUs for these products 


typically 


receive long streams of data, 


they can benefit from large pacing 


values. 


The determining factor is how 


much space you wish to devote to 
buffered data on the NCP. 
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DEFINING STATIONS ON SWITCHED SNA CONNECTIONS 


The physical and logical units of SNA stations connected by 
switched lines are defined in both ACF/VTAM and ACF/NCP. This 
section discusses how to code the necessary generation statements 
for ACF/VTAM (ACF/NCP generation is discussed in Section 3). The 
discussion covers only the statements needed for the DPS 6 (PU 
and LU). Further, not all macro-operands are discussed--only 
those that depend on the characteristics of the DPS 6 SNA 
products or the way those products are configured. See the 
appropriate IBM documentation for a discussion of the other 
aspects of ACF/VTAM generation. 


The DPS 6 configuration and ACF/VTAM generation must agree 
about certain characteristics of the communications connection 
between them. The Configuration Worksheets in the appendix 
should be used to ensure that the same values are given to both. 


Figure 4-1 is a sample ACF/VTAM Generation (partial) for a 
DPS 6 attached by a switched line. 
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SAMPLE VTAM DEFINITION (PARTIAL) FOR DPS 6 SNA 


SWITCHED LINE EXAMPLE 


VBUILD TYPE=SWNET 


KEKKKKEKKKEKEKEKKEKEEKKEKEKEKKEKKKKKEEKEKEKKKKEKKKKKKKEKEKEKEKEKKKKKKEKKEKKRKKK 


SWITCHED NETWORK DEFINTION 


DEFINITION OF INTERACTIVE TERMINAL FACILITY 3274 


* 

& 

* 

* 

* 

* 

x 

SWVGRP 

* 

* 

* 

S3274PU PU 
* 

SPATH] PATH 
* 

INTLUL LU 
INTLU2 LU 
INTLU3 LU 
INTLU4 LU 
INTLU5 LU 
INTLU6 LU 


Figure 4-l. 


ADDR=01, 
IDBLK=017, 
IDNUM=00001, 
DLOGMOD=H3278, 
IRETRY=YES, 
MAXDATA=265, 
MAXOUT=7, 
PACING=1, 
PASSLIM=11, 
PUTYPE=2, 
SSCPFM=USSSCS, 
RETRIES=(,1,4) 
VPACING=1 


DIALNO=5551212*, 


LOCADDR=2 
LOCADDR=3 
LOCADDR=4 
LOCADDR=5 
LOCADDR=6, 
DLOGMOD=H3 287 
LOCADDR=7, 
DLOGMOD=HSCS 


PU ADDRESS 
I.D. BLOCK 
I.D. NUMBER 


SET DEFAULT LOGON MODE (DISPLAY) 
RETRY POLLING AFTER IDLE T.O. 


MAXIMUM PIU SIZE 


MAXIMUM PIU'S BEFORE RESPONSE 


NCP-TO-LU PACING 
MAXIMUM CONSECUTIVE PIU'S 


PU TYPE 2 (CLUSTER CONTROLLER) 


CHARACTER CODED LOGONS 
M=64, T=1 SEC., N=4 SEC. 
VTAM-TO-NCP PACING 


NUMBER TO DIAL 

GROUP I.D. 

POINT TO NCP GROUP NAME 
FIRST PATH FOR THIS PU 


DISPLAY 1 LOCAL ADDRESS 
DISPLAY 2 LOCAL ADDRESS 
DISPLAY 3 LOCAL ADDRESS 
DISPLAY 4 LOCAL ADDRESS 
PRINTER LOCAL ADDRESS 
3270 PRINTER LOGON MODE 
PRINTER LOCAL ADDRESS 
SCS PRINTER LOGON MODE 


& 
% 
* 
* 
x 
* 


PS PS OS PS OS DS OS OS OM PS OOS DS 


mS OS 


Sample VTAM Definition for a Switched Line 
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* 


* DEFINITION OF REMOTE JOB ENTRY FACILITY 3777 
a | 


S3777PU PU ADDR=02, PU ADDRESS X 
IDBLK=013, I.D. BLOCK x 
IDNUM=00002, I.D. NUMBER X 
BATCH=YES, USE BATCH PRIORITY X 
DLOGMOD=BATCH, DEFAULT LOGON MODE (RJE FAC) xX 
IRETRY=YES, RETRY POLLING AFTER IDLE T.0. xX 
MAXDATA=521, MAXIMUM PIU SIZE X 
MAXOUT=7 , MAXIMUM PIU'S BEFORE RESPONSE xX 
PACING=(1,1), NCP-TO-LU PACING X 
PASSLIM=7, MAXIMUM CONSECUTIVE PIU'S X 
SSCPFM=USSSCS, CHARACTER CODED LOGONS X 
PUTYPE=2, PU TYPE 2 (CLUSTER CONTROLLER) X 
RETRIES=(,1,5) M=64, T=l SEC., N=5 SEC. 

* 

SPATH2 PATH DIALNO=5551212*, NUMBER TO DIAL X 
GID=2, GROUP I.D. X 
GRPNM=SGRP, POINT TO NCP GROUP NAME X 
PID=] FIRST PATH FOR THIS PU . 

* 

RJELUL LU LOCADDR=1 

RJELU2 LU LOCADDR=2 

RJELU3 LU LOCADDR=3 

RJELU4 LU LOCADDR=4 

RJELUS LU LOCADDR=5 

RJELU6 LU LOCADDR=6 

* 

* DEFINITION OF FILE TRANSFER 

* 

SSFTPU PU ADDR=03, PU ADDRESS X 
IDBLK=013, I.D. BLOCK X 
IDNUM=00003, I.D. NUMBER X 
BATCH=YES, USE BATCH PRIORITY X 
DLOGMOD=FILETRAN, SET DEFAULT LOGON MODE X 
IRETRY=YES, RETRY POLLING AFTER IDLE T.O. X 
MAXDATA=521, MAXIMUM PIU SIZE Xx 
MAXOUT=7 , MAXIMUM PIU'S BEFORE RESPONSE xX 
PACING=(4,1), NCP-TO-LU PACING X 
PASSLIM=7 , MAXIMUM CONSECUTIVE PIU'S X 
SSCPFM=USSSCS, CHARACTER CODED LOGONS X 
PUTYPE=2, PU TYPE 2 (CLUSTER CONTROLLER) X 
RETRIES=(,1,5) -M=64, T=1 SEC., N=5 SEC. 

‘ 3 

SPATH3 PATH DIALNO=5551212*, NUMBER TO DIAL X 
GID=3, GROUP I.D. X 
GRPNM=SGRP, POINT TO NCP GROUP NAME X 
PID=] | FIRST PATH FOR THIS PU 


FTLUL LU LOCADDR=1 
FTLU2 LU  _LOCADDR=2 


Figure 4-1 (cont). Sample VTAM Definition for a Switched Line 
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= DEFINITICN OF SNA PROGRAM INTERFACE 


SPIPU PU ADDR=04, PU ADDRESS X 
IDBLK=013, I.D. BLOCK X 
IDNUM=00001, I.D. NUMBER X 
USSTAB=H1IS3270 X 
DLOGMOD=H3 278, SET DEFAULT LOGON MODE(DISPLAY) X 
MAXDATA= 265, MAXIMUM PIU SIZE | X 
PACING=1, NCP-TO-LU PACING X 
PASSLIM=33, MAXIMUM CONSECUTIVE PIU'S X 
PUTYPE=2, PU TYPE 2 (CLUSTER CONTROLLER) X 
SSCPFM=USSSCS, CHARACTER CODED LOGONS X 
VPACING=1 VTAM-TO-NCP PACING 

SPILUL LU LOCADDR=2 SPI LU 01 LOCAL ADDRESS 

SPILU2 LU LOCADDR=3 SPI LU 02 LOCAL ADDRESS 

SPILU3 LU LOCADDR=4 SPI LU 03 LOCAL ADDRESS 

SPILU4 LU LOCADDR=5 SPI LU 04 LOCAL ADDRESS 

SPILU5 LU LOCADDR=6 SPI LU 05 LOCAL ADDRESS 

SPILU6 LU LOCADDR=7 SPI LU 06 LOCAL ADDRESS 

SPILU7 LU LOCADDR=8 SPI LU 07 LOCAL ADDRESS 

SPILU8 LU LOCADDR=9 SPI LU 08 LOCAL ADDRESS 

SPILU9 LU LOCADDR=10 SPI LU 09 LOCAL ADDRESS 

SPILUA LU LOCADDR=11 SPI LU 10 LOCAL ADDRESS 

SPILUB LU LOCADDR=12 SPI LU 11 LOCAL ADDRESS 

SPILUC LU LOCADDR=13 SPI LU 12 LOCAL ADDRESS 

SPILUD LU LOCADDR=14 SPI LU 13 LOCAL ADDRESS 

SPILUE LU LOCADDR=15 SPI LU 14 LOCAL ADDRESS 

SPILUF LU LOCADDR=16 SPI LU 15 LOCAL ADDRESS 

SPILUG LU LOCADDR=17 SPI LU 16 LOCAL ADDRESS 

SPILUH LU LOCADDR=18 SPI LU 17 LOCAL ADDRESS 

SPILUI LU LOCADDR=19 SPI LU 18 LOCAL ADDRESS 

SPILUJ LU LOCADDR=20 SPI LU 19 LOCAL ADDRESS 

SPILUK LU LOCADDR= 21 SPI LU 20 LOCAL ADDRESS 

SPILUL LU LOCADDR=22 SPI LU 21 LOCAL ADDRESS 

SPILUM LU LOCADDR= 23 SPI LU 22 LOCAL ADDRESS 

SPILUN LU LOCADDR=24 SPI LU 23 LOCAL ADDRESS 

SPILUO LU LOCADDR= 25 SPI LU 24 LOCAL ADDRESS 

SPILUP LU LOCADDR= 26 SPI LU 25 LOCAL ADDRESS 

SPILUQ LU LOCADDR=27 SPI LU 26 LOCAL ADDRESS 

SPILUR LU LOCADDR=28 SPI LU 27 LOCAL ADDRESS 

SPILUS LU LOCADDR=29 SPI LU 28 LOCAL ADDRESS 

SPILUT LU LOCADDR=30 SPI LU 29 LOCAL ADDRESS 

SPILUU LU LOCADDR=31 SPI LU 30 LOCAL ADDRESS 

SPILUV LU LOCADDR=32 SPI LU 31 LOCAL ADDRESS 

SPILUW LU LOCADDR=33 SPI LU 32 LOCAL ADDRESS 

Figure 4-1 (cont). Sample VTAM Definition for a Switched Line 
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PU_ (Switched) Statement 


The VTAM PU statement defines the characteristics of the 
DPS 6 SNA Interactive Terminal Facility (ITF), SNA Remote Job 
Entry (RJE) Facility, SNA File Transfer (SFT-6), or SNA 
Application Interface Facility (AIF) physical unit on a switched 
connection. | : 


The operands that must be coded for the DPS 6 SNA products 


are: 
PU ADDR=nn, 
IDBLK= eee 
O13) , 


IDNUM=mmmnn, 
MAXDATA= Erte 

521) , 
PASSL IM=3 3 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


ADDR=nn The station address is a hexadecimal number 
in the range X'01'-X'FE'. This value is 
referred to as PU ADDRESS in the 
Configuration Worksheets. It must agree with 
a corresponding parameter in the ITF, RJE 
Facility, SFT-6, or AIF configuration. 


IDBLK= ees A three-digit hexadecimal block number that 
013 depends on the product and is: 
ITF: 017 
RJE Facility: 013 
AIF: 013 
SFT-6: 013 
IDNU M=mmmnn The five-digit hexadecimal identification 


number as assigned by the network designer. 
This value is referred to as XID in the 
Configuration Worksheets. It must agree with 
a corresponding parameter in the ITF, RJE 
Facility, SFT-6, or AIF configuration. The 
last two characters must be the same as the 
ADDR parameter. 
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MAXDATA= 
PUTYPE=2 
PASSL IM=33 


265 
521 


} 


The size of the largest SDLC frame that can 
be sent to the DPS 6 is the size of the 
largest buffer (256 or 512 bytes) plus 9 
bytes of SNA header information. This value 
is referred to as MAXIMUM FRAME SIZE in the 
Configuration Worksheets. This operand must 
agree with a corresponding parameter in the 
ITF, RJE Facility, SFT-6, or AIF 
configuration. The value of FRAME SIZE for 
the ITF should be MAXDATA - 9. The values 
that you code depend on the product: 


ITF: 265 
RJE Facility: 265 or 521 
AIF: 265 or 521 
SFT-6: 265 or 521 


All of the SNA products are SNA physical 
units type 2. 


For the AIF only, the maximum number of 
consecutive Path Information Units (PIUs). 
This is the maximum number of information 
frames that can be sent before the host asks 
for a response. 
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LU (Switched) Statement 


The LU statement describes the characteristics of an ITF, RJE 
Facility, SFT-6, or AIF logical unit. 


The operands that must be coded for the DPS 6 SNA products 
are: 


LU LOCADDR=n, 
SSCPFM=USSSCS, 


Operands that are not required but for which recommendations 
can be made are: 


DLOGMOD=1logmode 
PACING=n 
V PACING=n 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


LOCADDR=n The local address of the ITF, RJE Facility, 
SFT-6, or AIF logical unit must agree with a 
corresponding parameter in the ITF, RJE 
Facility, SFT-6, or AIF configuration. This 
value is referred to as LU ADDRESS in the 
Configuration Worksheets. The values allowed 
depend on the product: 


ITF: 2 to 33 

RJE Facility: 1 to 6 
AIF: 2 to 33 

SFT-6: 1 to 6 


SSCPFM=USSSCS The DPS 6 SNA products only support 
character-coded logons,. 


DLOGMOD=logmode See "Logon Mode Table Definitions," later in 
this section. 
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PACING=n 


The SNA products adapt to the PACING 
parameters specified in the VTAM generation. 
Some things to take into account when 
deciding on the NCP-to-LU pacing are: 


ITF: Because a 3270 can only accept one 
screen of information at a time, the 
host software never sends more than 
that before waiting for a response, 
Nevertheless, an ITF LU should be coded 
with: 


PACING=1 


which means that every request unit 
sent to the LU is confirmed with a 
pacing response. | 


For ITF printer LUs, use a pacing value 
higher than l. A pacing value of 4 is 
common. 


RJE Facility, SFT-6, and AIF; 


Because LUs for these products 
typically receive long streams of data, 
they can benefit from large pacing 
values. The determining factor is how 
much space you wish to devote to 
buffered data on the DPS 6. 
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VPACING=n 


The main thing to take into account when 
deciding on the VTAM-to-NCP pacing parameter 
is its affect on the VTAM and NCP buffer 


pools: 


ITF: 


Because a 3270 can only accept one 
screen of information at a time, the 
host software never sends more than 
that before waiting for a response. 
Nevertheless, an ITF LU should be coded 
with: 


VPACING=1 
which means that VTAM sends NCP any 


information for the LU and then receive 
a pacing response. 


RJE Facility, SFT-6, and AIF: 


Because LUs for these products 
typically receive long streams of data, 
they can benefit from large pacing 
values. The determining factor is how 
much space you wish to devote to 
buffered data on the NCP, 
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ACF/VTAM APPLICATION 


_PROGRAM DEFINITION FOR SFT-H 


The host software for the SNA File Transfer includes a VTAM 
communications application called the Transmission Control 
Program. Like all other ACF/VTAM applications, the Transmission 
Control Program must provide an Application Identifier (APPLID) 
when opening the connection to ACF/VTAM. When creating the SFT-H 
default values table you can specify one or more application 
identifiers for the Transmission Control Program to use. You use 
the APPL statement to define these Application Identifiers to 
ACF/VTAM. This section discusses how to code the operands for 
the APPL statements. 


Figure 4-2 contains a sample APPL statement for SFT-H. 


FTF] APPL ACBNAME=FTF1, APPLID OF APPLICATION 


X 
AU TH= (ACQ, NOCNM, NOPASS, NOPO, NOTSO) , ALLOW ACQUIRE LU X 
EAS=199, UP TO 199 LU'S X 
MAXPVT=0 , X 
SRBEXIT=NO, X 
V PACING=4 


Figure 4-2. Sample APPL Statement for SFT-H 


The operands that must be coded for each SFT-H APPLID are: 


name APPL ACBNAME=acbname, 
AUTH= (ACQ[ , NOCNM] [,NOPASS] [,NOPO] [,NOTSO] [,VPACE]), 
EAS=nnn, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


name or The application name should agree with one of 
acbname the VTAM APPLIDs in the SFT default values table. 


AUTH=(ACQ [,NOCNM] [,NOPASS] [,NOPO] [,NOTSO] [,VPACE]), 


The operand ACQ is required so that the 
application can connect to the SFT-6 logical 
units. The other operands are the VTAM defaults 
but may be coded as shown, if desired. 


EAS=nnn The maximum number of sessions that can be active 
concurrently. This value should be greater than 
Or equal to the MAXSESS parameter for the 
Transmission Control Program. SFT-H can support 
up to 199 concurrent sessions. 
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LOGON MODE TABLE DEFINITIONS 


When VTAM establishes a session between two logical units 
(such as between an ITF display and Customer Information Control 
System (CICS)), it needs more information about the 
characteristics of the session than is available from the ACF/NCP 
generation. It gets this additional information from one of two 
sources: 


1. From the host application 
2. From a LOGMODE entry in a VTAM logon mode table. 


Certain host systems, such as the CICS and Information 
Management System (IMS), always supply the necessary 
information. For example, the CICS uses the information in its 
Terminal Control Table (TCT) to set the characteristics of the 
session. When the host system Supplies the session parameters, a 
LOGMODE entry is not needed. 


Host systems like TSO and NCCF, however, do not supply the 
session parameters for the devices they support. For these and 
Similar systems, VTAM gets the session parameters from the logon 
mode table. The entry in the logon mode table that VTAM uses is 
specified either explicitly in the user logon or by default from 
the DLOGMOD parameter in the NCP or VTAM generation. 


The IBM-Ssupplied logon mode table ISTINCLM has a LOGMODE 
entry named "BATCH" that is suitable for RJE Facility logical 
units. You must code additional entries, however, for the other 
SNA products. 


The sample logon mode table entries in Figure 4-3 give 
examples of LOGMODE definitions for all of the SNA products. For 
completeness, the LOGMODE entry for the RJE Facility is also 
included. 
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* * 
il SAMPLE LOGON MODE TABLE ENTRIES FOR HIS SNA PRODUCTS * 
* * 


KEKEKKEKKEKEKEKE EEE EERE KEKE KEE EKER KEE KEEKEEEKEKEKRREREEEEKEEEKKKKKEKS 
* 


an INTERACTIVE TERMINAL FACILITY 

* 

HDISPLAY MODEENT LOGMODE=H3278, VIP DISPLAY AS 3278 DISPLAY X 
FMPROF=X'03', FUNCTION MANAGEMENT PROFILE 3 X 
TSPROF=X'03', TRANSMISSION SERVICES PROFILE 3 X 
PRIPROT=X'B1', PRIMARY LU PROTOCOLS X 
SECPROT=X'BO', SECONDARY LU PROTOCOLS X 
COMPROT=X'3080', COMMON LU PROTOCOLS ‘ 
RUSIZES=C'8787', RU SIZES UP TO 1024 X 
PSERVIC=X'020000000000185018507F00' PS PROTOCOLS 

* 

HDSPRINT MODEENT LOGMODE=H3287, 3270 DATA STREAM PRINTER X 
FMPROF=X'03', FUNCTION MANAGEMENT PROFILE 3. X 
TSPROF=X'03', TRANSMISSION SERVICES PROFILE 3 X 
PRIPROT=X'B1', PRIMARY LU PROTOCOLS X 
SECPROT=X'BO', SECONDARY LU PROTOCOLS X 
COMPROT=X'3080', COMMON LU PROTOCOLS X 
RUSIZES=X'8787', RU SIZES UP TO 1024 X 
PSERVIC=X'030000000000185018507F00' PS PROTOCOLS 

* 

HSCSPRT MODEENT LOGMODE=HSCS, SNA CHARACTER STRING PRINTER X 
FMPROF=X'03', FUNCTION MANAGEMENT PROFILE 3 X 
TSPROF=X'03', TRANSMISSION SERVICES PROFILE 3 X 
PRIPROT=X'Bl', PRIMARY LU PROTOCOLS X 
SECPROT=X'BO', SECONDARY LU PROTOCOLS X 
COMPROT=X'3080', COMMON LU PROTOCOLS X 
RUSIZES=X'8787', RU SIZES UP TO 1024 : 
PSERVIC=X'01000000FBO0000000FB0000' PS PROTOCOLS 

& 

REMOTE JOB ENTRY FACILITY 

* 

HRJE MODEENT LOGMODE=BATCH, REMOTE JOB ENTRY WORKSTATION X 
FMPROF=X'03', FUNCTION MANAGEMENT PROFILE 3. X 
TSPROF=X'03', TRANSMISSION SERVICES PROFILE 3 X 
PRIPROT=X'A3', PRIMARY LU PROTOCOLS X 
SECPROT=X'A3', SECONDARY LU PROTOCOLS X 
COMPROT=X'7080', COMMON LU PROTOCOLS X 
RUSIZES=X'4747', RU SIZES UP TO 512 X 


PSERVIC=X '011000000000000000000000' PS PROTOCOLS 


Figure 4-3. Sample Logon Mode Table Entries for DPS 6 SNA 
Products 
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is FILE TRANSFER FACILITY 


HFTF MODEENT LOGNODE=FILETRAN, SNA FILE TRANSFER xX 
FMPROF=X'03', FUNCTION MANAGEMENT PROFILE 3. X 
TSPROF=X'03', TRANSMISSION SERVICES PROFILE 3 X 
PRIPROT=X'91', PRIMARY LU PROTOCOLS X 
SECPROT=X'90', SECONDARY LU PROTOCOLS X 
COMPROT=X'3080', COMMON LU PROTOCOLS X 
RUSIZES=X'8787', RU SIZES UP TO 1024 X 
PSERVIC=X'010000000000000000000000' PS PROTOCOLS 

* 

* SNA PROGRAM INTERFACE 

* 

MODELUO MODEENT LOGMODE=MODELUO, SNA PROGRAM INTERFACE X 
FMPROF=X'04', FUNCTION MANAGEMENT PROFILE 4 X 
TSPROF=X'04', TRANSMISSION SERVICES PROFILE 4 X 
PRIPROT=X'Bl', PRIMARY LU PROTOCOLS X 
SECPROT=X'BO', SECONDARY LU PROTOCOLS X 
COMPROT=X'3080', COMMON LU PROTOCOLS X 
RUSIZES=X'8787', RU SIZES UP TO 1024 X 
PSERVIC=X'010000000000000000000000' 24X80 DEFAULT 

* 

* 

* 

CICSLUO MODEENT LOGMODE=CICSLUO, SNA PROGRAM INTERFACE X 
FMPROF=X'04', FUNCTION MANAGEMENT PROFILE 4 X 
TSPROF=X'04', TRANSMISSION SERVICES PROFILE 4 X 
PRIPROT=X'Bl', PRIMARY LU PROTOCOLS x 
SECPROT=X'BO', SECONDARY LU PROTOCOLS X 
COMPROT=X'7480', COMMON LU PROTOCOLS X 
RUSIZES=X'8585', X 


PSERVIC=X‘'010000000000000000000000' 24X80 DEFAULT 


Figure 4-3 (cont). Sample Logon Mode Table Entries for DPS 6 
SNA Products 
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PACING VALUES 
Host pacing values can be defined in one of ‘two ways: 
@ On the ACF/VTAM statement that defines the logical unit 


@e On the LOGMODE table entry statement used to derive the 
BIND parameters. 


Table 4-1 summarizes the statements that control pacing. 
Table 4-1, Pacing-Related Keywords 


| ACF/VTAM 
Statement | Keyword Meaning 


APPL | | VPACING= | Secondary to Primary (i.e., from SFT- 
: | to SFT-H). 


| MODEENT PSNDPAC= | Primary to Boundary Function Node (i.e. | 
SFT-H to 3705 connected to SFT-6). | 


| LU | VPACING= Primary to Boundary Function Node if 
| | PSNDPAC=0. 


PU V PACING= Primary to Boundary Function Node if 
PSNDPAC=0 and LU VPACING=0. 


MODEENT SRCVPAC= | Boundary Function Node to SFT-6. 


LU | PACING= Boundary Function Node to SFT-6 if 
SRCVPAC=0. 


PU | PACING= Boundary Function Node to SFT-6 if 
SRCVPAC=0 and LU/PACING=0. 


NOTE 


VPACING/PACING can be specified on LU, PU, LINE, or GROUP 
statements. 


An SFT-H selection of a LOGMODE table entry is controlled via 
the Utility Control Language ADDLU LOGMODE keyword. If 
specified, the indicated entry will be used. If not specified, 
ACF/VTAM will select a default entry. (A logon mode table and/or 
default entry name may be specified on ACF/VTAM generation 
statements. The macros are: LU, PU, LINE, or GROUP: the 
keywords are: MODETAB or DLOGMOD). 


An SFT-H selection of an application identity (APPLID) is 
controlled by customer-Supplied values in the SFT-H default 
values table. 
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You can specify up to four APPLID values. During the 
transmission program initialization, the application identities 
are used in turn until a nonbusy application ID is found. You 
can control application identities, and thus VPACING or inbound 
pacing counts, by having several load libraries, each with a 
default value table containing different application identities. 


For cross domain sessions, inbound pacing can occur in two 
stages: 


e SFT-6 to Boundary function pacing is controlled by the 
MODEENT keyword SSNDPAC. 


@e Boundary function to SFT-H pacing is controlled by the 
APPLID keyword VPACING. 


Outbound pacing (SFT-H to SFT-6) is unchanged. 
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Section 5 


DEFINING ITF TO 
INTERACTIVE SYSTEMS 


This section provides information about the DPS 6 SNA 
Interactive Terminal Facility (ITF) that may be needed by host 
systems programmers and application designers. The first 
subsection describes which features of the IBM 3270 terminal 
family ITF emulates and which features it does not. The 
information is useful for analysts who must design host 
applications. The rest of this section discusses how to code the 
terminal definition statements for the Customer Information 
Control System (CICS) and the Information Management System 
(IMS). 


3270 FEATURE SUPPORT 


The Interactive Terminal Facility (ITF) emulates an IBM 
3274-1C Terminal Controller. The Honeywell terminals supported 
by the ITF appear to the host as IBM 3278 Model 2 Display 
Stations with typewriter keyboards. The Honeywell printers 
Supported by ITF appear as IBM 3287 Model 2 Printers. 


The ITF emulates the standard features of the IBM 3278, 
including: 


1920-character screen 

25th line status display 

Field attributes (alpha/numeric, protected, etc.) 
Extended attributes (blink, reverse video, underscore) 
PF1-PF24 

PAI-PA3. 
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Printers attached to the ITF can be used as 3270 Data Stream 
printers or SNA Character String (SCS) printers. 


The ITF does not support these features of the IBM 3278/3287: 
@ Programmed symbols 

e Screen sizes other than 1920 characters 

@® Badge reader 


e Light pen (although you can use light-pen-detectable 
fields with the CURSOR SEL key). 


CICS DEFINITION OF ITF DEVICES 


This subsection discusses how to code the CICS terminal 
control table generation macro DFHTCT for the ITF. Not all the 
DFHTCT operands are discussed--only those that depend on the | 
Characteristics of the ITF or the way the ITF is configured. See 
the appropriate IBM documentation for a discussion of the other 
aspects of CICS generation. 


The ITF configuration and CICS generation must agree about 
certain characteristics of the ITF devices. Use the 
Configuration Worksheets in the appendix to ensure that the same 
values are given to both. 
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ee 


 DFHTCT Macro 


The DFHTCT macro defines the characteristics of terminals and 


printers to the CICS Terminal Control Program. 


The operands that must be coded for all ITF devices are: 


DFHTCT TYPE=TERMINAL, | 
ACCMETH=VTAM, 


BRACKET=YES, 

NETNAME=luname, 
256 

RUSIZE=) 512 ’ 
768 
1024 


In addition, other operands must be coded depending on the 
specific types of ITF devices, as follows: 


For displays: 


TRMTYPE=LUTYPE2, 
TRMMODL=2, 
FEATURE=(DCKYBD, SELCTPEN, AUDALARM, HILIGHT [,UCTRAN]), 


CHNASSY=YES, 
DEFSCRN= (24,80), 


For printers acting as 3270 printers: 
TRMTYPE=LUTYPE3, 
TRMMODL=2, 
PGESIZE=(24,80), 
For printers acting as SCS printers: 
TRMTYPE=SCSPRT, 
FF=YES, 
HF=YES, 
VF=YES, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 

ACCME TH=VTAM ITF supports only VTAM. 

BRACKET=YES  #ITF uses bracket protocols. 


NETNAME=luname This name must agree with the name assigned 
to the LU on the ACF/NCP LU generation macro. 
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256 The maximum RU size for a device 

51.2 must agree with a corresponding 

RUSIZE=) 768( , parameter of the ITF generation. 
1024 This value is referred to as MAXIMUM RU SIZE 

in the Configuration Worksheets. 


FOR DISPLAYS 
TRMTYPE=LUTYPE2 Indicates a display. 


TRMMODL=2 Displays attached to ITF emulate the IBM 3278 
Model 2 (1920 character screen). 


FEATURE= (DCKYBD, SELCTPEN, AUDALARM,HILIGHT [,UCTRAN]), 
ITF displays emulate the 3270 Typewriter 
keyboard and support light-pen-detectable 
fields (using the CURSOR SEL key), the 
audible alarm and extended highlighting. 
Uppercase translation may be used, if 
desired. 


CHNASSY=YES The CICS should assemble an entire chain 
before passing it to an application. 


DEFSCRN=(24,80) The ITF supports only the 1920-character 
screen, 


FOR PRINTERS ACTING AS 3270 PRINTERS 
TRMTYPE=LUTYPE3 Indicates a 3270 printer. 


TRMMODL=2 Printers attached to the ITF emulate the IBM 
3287 Model 2. 


PGESIZE=(24,80) The ITF supports only the 1920-character page 
size for 3270 printer emulation. 


FOR PRINTERS ACTING AS SCS PRINTERS 


TRMTYPE=SCSPRT Indicates an SCS printer. 


FF=YES Allows the use of SNA Character String 
HF=YES control characters. 
VF=YES 3 


Figure 5-1 contains a sample CICS TCT GEneERELOU a a 
for the ITF. 
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KKK IKI IRIE KKK EEK EEE IKI EERIE EEE REE EEE HMEREEEEREEKEKEEEKKEKKEKEK 


% 
* 
* 


SAMPLE CICS TCT GENERATION (PARTIAL) FOR DPS 6 SNA 
INTERACTIVE TERMINAL FACILITY 


* 
* 
* 


* % 
KRKEEKKKKKKEKKEKEKEKKKEKEKEKEKEKEKEKRKEKKEKKERKERKEEEREKEKEERKEEKEREKEEEKEKEKKKESE 
* 


* DEFINE A DISPLAY TERMINAL 

*& . 

HISTERM DFHTCT TYPE=TERMINAL, DEFINE A 3270 DISPLAY X 
ACCMETH=VTAM, REQUIRES VTAM SUPPORT X 
NETNAME=INTLU1 , POINT TO LU NAME IN NCP GEN. X 
RELREQ=(YES,YES) , RELEASE WHEN NOT IN USE X 
CHNASSY=YES, . ASSEMBLE FULL CHAINS X 
TCTUAL=255, PCI LENGTH X 
FEATURE= (DCKYBD, SELCTPEN , AUDALARM, HILIGHT, UCTRAN) , X 
BRACKET=YES, USE BRACKETS Xx 
TRMIDNT=TRM1, CICS TERMINAL NAME X 
TRMMODL=2, 1920 CHARACTER SCREEN X 
BUFFER=0, TAKE WHAT APPL. GIVES X 
RUSIZE=1024, SIZE OF 3270 RU X 
TRMSTAT= (TRANSCEIVE) , STARTING STATUS Xx 
TRMTYPE=LUTYPE2, SNA 3270 DISPLAY X 
CONNECT=NO, DON'T AUTOMATICALLY CONNECT X 
PGESTAT=PAGE, PAGE HANDLING X 
PGESIZE=(24,80) , PAGE SIZE FOR BMS X 
ALTPGE=(24,80) , NO ALTERNATE PAGE SIZE X 
DEFSCRN= (24,80) , 3270 SCREEN SIZE X 
ALTSCRN=(24,80) , NO ALTERNATE SCREEN SIZE X 
TIOAL= (1024 ,4096) TERMINAL I/O AREA SIZE 

* 

“d DEFINE A 3270 DATA STREAM PRINTER 

* 

HISDSP DFHTCT TYPE=TERMINAL, 3270 D.S. PRINTER X 
ACCMETH=VTAM, REQUIRES VTAM SUPPORT X 
NETNAME=INTLU5, POINT TO LU NAME IN NCP GEN. X 
BRACKET=YES, USE BRACKETS X 
TRMIDNT=PTRI, CICS TERMINAL NAME ».¢ 
TRMMODL=2, 1920 CHARACTER SCREEN X 
BUFFER=0, TAKE WHAT APPL. GIVES Xx 
RUSIZE=1024, SIZE OF 3270 RU X 
TRMSTAT= (TRANSCEIVE) , STARTING STATUS X 
TRMTYPE=LUTYPE3, SNA 3270 PRINTER X 
PGESIZE=(24,80) , PAGE SIZE FOR BMS X 


TIOAL=2048 TERMINAL I/O AREA SIZE 


* 


* DEFINE AN SNA CHARACTER STRING (SCS) PRINTER 
* 


HISSCS DFHTCT TYPE=TERMINAL, 
ACCMETH=VTAM, 
NETNAME=INTLU6 , 
BRACKET=YES, 
RUSIZE=1024, 
TRMIDNT=SCS1, 
TRMSTAT=RECEIVE, 
TRMTYPE=SCSPRT, 


SCS PRINTER X 
REQUIRES VTAM SUPPORT X 
POINT TO LU NAME IN NCP GEN. Xx 
USE BRACKETS X 
SIZE OF 3270 RU Xx 
CICS TERMINAL NAME X 
STARTING STATUS X 
SNA 3270 PRINTER X 

X 

Xx 

X 


FF=YES, ALLOW FORM FEEDS | 
HF=YES, ALLOW HORIZONAL FORMAT CONTROLS 
VF=YES, ALLOW VERTICAL FORMAT CONTROLS 

T IOAL=2048 TERMINAL I/O AREA SIZE 


Figure 5-1. Sample CICS TCT Generation for ITF 
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IMS DEFINITION OF ITF DEVICES 


This subsection discusses how to code the IMS generation 
macros for the ITF. Not all the operands are discussed--only 
those that depend on the characteristics of ITF or the way ITF is 
configured. See the appropriate IBM documentation for a 
discussion of the other aspects of IMS generation. 


The ITF configuration and IMS generation must agree about 
certain characteristics of the ITF devices. Use the 
Configuration Worksheets in the appendix to ensure that the same 
values are given to both. 


Figure 5-2 contains a sample IMS generation (fragment) for 
the ITF. 


KREKKEEKKEKKEKKKEKEKEKKRKEKKEKKEKKKEKEKKKKEKEKEKKEKKKEEKKKKKKEEKEKEKEKEKEKKEKEKEKKEKKKKKKKES 


* * 
ig SAMPLE IMS TERMINAL DEFINITION (PARTIAL) FOR DPS 6 SNA * 
* INTERACTIVE TERMINAL FACILITY * 
* * 


KRKEKKRKEKKKEKKKKEKEKEKKKKEKREKEKKKKEKEKKKEKREKEKEKEKKKEKKEKKEKKKEKEKEKKKEEKEKKKKKKKEKE 
* 


TYPE UNITYPE=SLUTYPE2 DEFINE DISPLAYS 
* 
TERMINAL NAME=DISPl, LU NAME Xx 
MODEL=2, 1920 CHAR SCREEN X 
FEAT=(PFK,NOCD, PEN) TERMINAL FEATURES 
* 
TYPE UNITYPE=SLUTYPE1] DEFINE SCS PRINTERS 
* 
TERMINAL NAME=SCS1, LU NAME Xx 
COMPT1=(PRINTER] ,MFS-SCS1) SCS PRINTER 


NAME PTR1,COMPT=1 


Figure 5-2. Sample IMS Terminal Definition for the ITF 
TYPE Macro 


The TYPE macro is the first of a set of terminal description 
macro statements. 


The operands that must be coded for the ITF are: 
For displays: 


TYPE UNITYPE=SLUTYPE2, 
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For SCS printers: 


TYPE UNITYPE=SLUTYPE1, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


UNITYPE= pope: 
SLUTYPE2 


ITF devices appear to IMS as SNA Logical 
Units Type 1 (SCS Printer) or Type 2 
(Display). 


TERMINAL Macro 


The TERMINAL macro defines the phySical and logical 
characteristics of the ITF device. 


The operands that must be coded for the ITF are: 
For displays: 


TERMINAL NAME=nodename, 
MODEL=2, 
FEAT=(PFK, NOCD, PEN) , 


For SCS printers: 


TERMINAL NAME=luname, 
COMPT1=(PRINTERL,MFS-SCS1) , 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 
NAME= Epona This name must agree with the name 
luname assigned to the device on the ACF/NCP 
generation macro, 


MODEL=2 An ITF display appears as a 3270 Model 2 
with a 1920-character screen. 
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FEAT= (PFK, NOCD, PEN) 
The ITF supports 24 function keys and 
light-pen detectable fields (using the 
CURSOR SEL key), but does not support a 
badge reader. 
COMPT1=(PRINTERI1,MFS-SCS1) 


The ITF expects SNA Character Strings for 
IMS printers. 
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Section 6 


DEFINING THE RJE 
FACILITY TO JES2 


This section discusses how to code the MVS Job Entry 
Subsystem 2 (JES2) generation parameters for the DPS 6 Remote Job 
Entry (RJE) Facility. The RJE Facility provides complete 
emulation of an IBM 3777 Model 3 RJE workstation. Each copy of 
the RJE Facility can, therefore, support a console and up to six 
unit record devices (readers, printers, punches, diskettes) or 
disk files that appear to the host to be unit record devices. 


This discussion covers only the JES2 RMTnnnn parameter that 
defines the characteristics of SNA RJE workstations. Not all 
operands are discussed--only those that depend on the 
characteristics of RJE or the way RJE is configured. See the 
appropriate IBM documentation for a discussion of the other 
aspects of JES2 generation. 


The number and types of unit record device associated with 
the RJE Facility are set by the RJE Facility operator using RJE 
Facility commands. The network administrator must make sure that 
the configurations used by the RJE Facility operators agree with 
the configurations described to JES2 in the RMTnnnn. PRm, 

RMTnnnn. PUm, and RMTnnnn.RDm parameters. 


The RJE Facility configuration and JES2 generation must agree 
about certain characteristics of the workstation. Use the 
Configuration Worksheets in the appendix to ensure that the same 
values are given to both. 
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Figure 6-1 contains a sample JES2 Generation (fragment) for 
the RJE Facility. 


HRKAKKKEKKKKKKKEEKEEREKKEKKEKEEKKKKEKEEEKEKKEKKKEKREERKEEKEEKKKEKKEKKEKKKRKEKKKKKKKKEKE 


Z * 
* SAMPLE JES2 RJE FACILITY DEFINITION (PARTIAL) | . 
: * 


RKKKKEKKEKEKEKEKEEKKEKEKKKKKEKKEKEEKEKKKKEKEKEKEKEKEKEKREKKKRKEKKEKEKEKKKKKKKEKKKKESK 
* 


RMT1 LUTYPE1, BUFSIZE=256, COMP, NUMRD=4 , NUMPR=4,NUMPU=2, Xx 
CONSOLE, SETU PMSG 

R1.RD1 CLASS=A 

Rl .RD2 CLASS=A 

R1 .RD3 CLASS=A 

R1 .RD4 CLASS=A 

R1 .PR1 CLASS=A, PRWIDTH=132 , CKPTLNS=3 2767 , CKPTPGS+3 2767 

Rl. PR2 CLASS=A, PRWIDTH=132,CKPTLNS=3 2767 , CKPTPGS=3 2767 

Rl .PR3 CLASS=A, PRWIDTH=1 28 , CKPTLNS=3 2767 , CKPTPGS=3 2767 

Rl. PR4 CLASS=A, PRWIDTH=1 28 , CKPTLNS=3 2767 , CKPTPGS=3 2767, SELECT=EXCH1 
R1 . PUL CLASS=B, CKPTLNS= 32767, CKPTPGS= 32767 

R1 .PU2 CLASS=B, CKPTLNS=3 2767 , CKPTPGS=3 2767 , SELECT=BASIC1 , NOCTL 


Figure 6-1. Sample JES2 Definition for the RJE Facility 


CODING THE JES2 RMTnnnn MACRO 
The operands that must be coded for the RJE Facility are: 


RMTnnnn LUTYPE1, 
BUFSIZE= tes, , 
| 512 
CONSOLE, 
SETUPMSG, 


Operands that are not required but for which recommendations 
can be made are: 


COMP/NOCOMP 
CMPCT/NOCMPCT 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


LUTYPE1 SNA RJE workstations are logical units 
type l. : 
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BUFSIZE= fara 
512 


CONSOLE 


SETU PMSG 


COMP/NOCOMP 


CMPCT/NOCMPCT 


The maximum buffer size to be sent to the 
RJE Facility workstation must agree with a 
corresponding parameter in the RJE Facility 
configuration. This value is referred to as 
MAXIMUM RU SIZE in the Configuration 
Worksheets. The value of MAXIMUM RU SIZE 
should be less than or equal to the value of 
BUFSIZE in the JES2 remote station 
definition. 


The RJE Facility always uses a console. 


JES2 should tell the RJE Facility operator 
about a forms mount by way of a console 
message. | 


Compression/expansion usually reduces the 
amount of time required for transmission 
substantially and should be used unless there 
is some compelling reason not to. 


Use CMPCT if the RJE Facility will receive 
compacted data from the host. 
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Section 7 


INSTALLING SFT ON 
THE HOST 


This section discusses host-resident files needed by the SNA 
File Transfer Facility (SFT-HOST). Job control language to 
create these files is included on the installation tape; this 
section is provided in case you wish to alter the file 
Characteristics. 


Installing the SFT on an IBM host consists of: 


1. 


7. 


Coding ACF/NCP generation macros for the SFT 
Coding ACF/VTAM generation statements for the SFT 
Creating and loading the SFT-H libraries 

Creating the default values table 

Creating the SFT files 


Creating a security table for the online operator 
interface (optional) 


Loading the SFT files. 


Steps 1 and 2 are described in Sections 3 and 4, 
respectively. This section describes steps 4, 5, and 6. Steps 3 
through 7 are controlled by the distribution tape, which contains 
JCL for loading SFT files. 
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SFT-H INSTALLATION TAPE 


The installation tape includes an instruction file (file 7). 
Use the following JCL to dump file 7 of the tape to a partitioned 
data set that will be referenced throughout the install process 
and print down the instruction document. 


//JOBNAME JOB ACCOUNTINGINFO,'USER INFO',CLASS=A, MSGCLASS=A 
//DUMPFIL7 EXEC PGM=IEBCOPY 
//SYSPRINT DD SYSOUT=* 
//INTAPE DD DSN=SFTHR12. INSTALL, UNIT=TAPE, 
// LABEL=(7,SL) , 
//  VOL=SER=HISSFT, 
// DCB= (LRECL==80 , BLKS1ZE=6 160, RECFM=FB) 
//OUTPDS DD DSN=NNNNNNNN. SFTHR12. INSTALL, 
7 DISP=(NEW, CATLG, DELETE) , 
// UNIT=DISK, 
// SPACE=(CYL, (5,2,40) ,RLSE), 
// DCB=(LREC=80,BLKS1IZE=6160,RECFM=FB) , 
// VOL= SER=XXXXXX 
//SYSIN DD * 
F COPY INDD=INTAPE, OUTDD=OUTPDS 
* 
//PRINTDOC EXEC PGM=IEBGENER 
//SYSIN DD DUMMY 
//SYSPRINT DD SYSOUT=* 
//SYSUT1 DD DSN=NNNNNNNN, SFTHR12.INSTALL(SFTHDOC) ,DISP=SHR 
//SYSUT2 DD SYSOUT=*, DCB=(LRECL=80,BLKSIZE=800, RECFM=FBA) 


Change NNNNNNNN to your installation's high level index 
name. Change XXXXXX to the disk volume on which the partitioned 
data set will reside. Substitute valid information for JOBNAME, 
ACCOUNTINFO, 'USER INFO!', and UNIT. 
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UPDATING THE DEFAULT VALUES TABLE 


The default values table contains installation-dependent 


defaults that are used by the File Maintenance Utility (SFTBATCH) 
and the Transmission Control Program (SFTTCP). You can override 
values in the default values table using PARM= parameters on the 
EXEC card that executes SFTBATCH or SFTTCP. 


with SFT, 

TITLE 'DEFAULT VALUES TABLE ! 

* 

FTDFLT MODE=START, START, NOT RESTART 
DEBUG=NO, DEBUG MODE (FILE MAINT. UTILITY) 
TPSFDD=9, MAX NUMBER OF STAGING FILE DD CARDS 
ERROPT=ABT, ON ALL ERRORS, ABORT SESSION IS DFLT 
RU NID=22222222, RUN IDENTIFIER 
MSGPASS=TESTPASS, VSAM PASSWORD FOR MESSAGE FILE 
VTAM1L=(FTF4,PASS4), VTAM APPLID / PASSWORD ALTERNATE 
VTAM2=(FTF3,PASS3), VTAM APPLID / PASSWORD ALTERNATE 
VTAM3=(FTF2,PASS2), VTAM APPLID / PASSWORD ALTERNATE 
VTAM4=(FTF1), — VTAM APPLID = FTF1, NO PASSWORD 
SFINDDP=INSFPASS, PASSWORD FOR INPUT STAGING FILES 
SFOTDDP=OTSFPASS, PASSWORD FOR OUTPUT STAGING FILES 
BLKOUT=NO BLOCK TO FULL RUS 

END 


Figure 7-1. Default Values Table Supplied with SFT 


The following values are used by both SFTBATCH and SFTTCP: 


DEBUG= ee 
NO 


Generate diagnostic SNAPDUMPs or suppress them. Valid 
values are YES or NO. The default is NO. 


INDD=input_ staging file 


Default input staging file DD name used for SEND and 
UNSTAGE operations when an INDD= value is not 
supplied. Specify any valid DD name (one to eight 
alphanumeric characters with the first character 
alphabetic). The default is FTSFIN. 


SFINDDP=passwordl 
Password for DD name specified by INDD. Valid values: 


one to eight alphanumeric CHSEACCCEC: Default: no 
password. 
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Figure 7-1 contains the default values table that is supplied 


PS PS PS OS PS OS PS OS OS OOS OS OO 


1 


OUTDD=output_ staging file 
Default output staging file DD name used for RECEIVE 
and STAGE operations if no OUTDD= value is supplied. 
Use any valid DD name. The default is FTSFOUT. 
SFOTDDP=password2 


Password for DD name specified by OUTDD. Valid 
values: one to eight alphanumeric characters. 
Default: no password. 


RMFPASS=password3 


Resource master file VSAM password specified when the 
VSAM cluster was defined. Default: no password. 


HSTPASS=password4 


History file VSAM password specified when the VSAM 
cluster was defined. Default: no password. 


MSG PASS=password5 


Message file VSAM password specified when the VSAM 
cluster was defined. Default: no password. 


TCFPASS=password6 


Transmission control file VSAM password password 
specified when the VSAM cluster was defined. Default: 
no password. 


TS FPASS=password7 


Transmission status file VSAM password specified when 
the VSAM cluster was defined. Default: no password. 


PRIO=priority 


Priority assigned to session when priority is not 
specified in the ADDSES statement. Valid values are 0 
through 255; sessions with priority 0 execute first. 
The default value is 128. Note that this is the 
priority within the current execution of the SFT-H, not 
the priority in relation to MVS. 


SOU RCE=source 
Value used during staging operations if the SOURCE= 
parameter is not specified. Valid values are one 


through eight alphanumeric characters. The default 
value is IBM. 
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® BUSFDD=max_numberl 


Maximum number of staging files used by SFTBATCH. 
BUSFDD is an integer between 1 and 32,767; the default 
value is 0. 


@® TPSFDD=max_number2 


Maximum number of staging files used by SFTTCP. TPSFDD 
is an integer between 1 and 32,767; the default value 
is 0. © 


e SFSTR=requests 


Default number of concurrent I/O requests to allow for 
each staging file. SFSTR is an integer between 1 and 
255. This value can be overridden on the DD statement 
for an individual staging file. SFSTR should not 
exceed MAXSESS (see below). The default is 5. 


The following values are used by SFTTCP only: 
® ERROPT=option 
Default error option used when ERROPT= is not specified 


on either an ADDSES or an ADDACT statement. Valid 
values are: 


DEF -- Follow internal default of Abort Session 
OPR -- Ask operator to specify error option 

IGN -- Continue with next action 

ABT -~- Abort session; do not retry. 


The default is ABT. 

@ RTCODE=code 
Routing code used for all system console messages. 
RTCODE is an integer between 1 and 15. fThe default 
Le. 5< 

@® MAXSESS=number 
Default maximum number of SFT-H/SFT-6 sessions 
allowed. SFT-H/operator sessions are not included in 
this value. MAXSESS is an integer between 1 and 200. 
The default is 5. 

® INTRACE=entries 
Number of 32-byte entries in the SFTTCP internal trace 


table. INTRACE is an integer between 0 and 32,767. 
The default is 1000. 
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e cine 
\OFF 


Trace SFTTCP activity via GTF or not. The valid values 
are ON (trace activity) or OFF (doe not trace 
activity). The default is OFF. 


@ MODE=operation mode 


SFTTCP mode of operation, Valid values are START and 
RESTART. START means discard all records of previously 
attempted and completed activity. RESTART means 
continue with work not previously completed. The 
default is RESTART. 


e RUNID=identifier 


One to eight alphanumeric characters used as an 
identifier in all history file records created by 
SFTTCP. The first three characters are also used as a 
prefix for all messages sent to the system console. 
The supplied default is 22222222. 


@ NOMTIME=time 


Nominal starting time for SFTTCP. A session defined 
with a non-zero time but no date (for example, a job 
that is to be run daily after some specified time) is 
considered ready to execute when (1) the real wall 
clock time is later than the session time, and (2) 
NOMTIME is later than the session time. This parameter 
can be useful when a session is defined with a time 
near midnight and SFTTCP is executed (either in START 
Or RESTART mode) just after midnight. 


@® EXREQS=req_num 
Maximum number of online operator interface logons 


permitted. EXREQS is an integer from 1 through 10. 
The default is 5. 


@e BLKOUT= on 
NO 


Enable or disable record blocking during transmission. 
The default is NO. 
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UPDATING SFT FILES 
The SFT-H requires the following files: 


History file 

Resource master file 
Transmission control file 
Transmission status file 
Staging file(s) 

Message file 

Prototype file. 


Staging files are required for Receive actions, optional for Send 
actions, and used as a work file for some summary reports. You 
must allocate the message file, but the file is loaded from the 
distribution tape when the SFT-H is installed. The prototype 
file, used aS a source of dummy records when SFT files are 
cleared, must be loaded from the distribution tape. Directions 
for loading the file are on the tape. 


Be sure that the volume you specify has sufficient space to 
create and define the files. If you use the 'REUSE' option, then 
be sure the volume has enough VSAM data space. (Table 7-2 
contains formulas for estimating file sizes.) 


Create empty VSAM files using the Access Method Services 
Utility IDCAMS. (IDCAMS is described in detail in the IBM manual 


OS/VS2_ Access Method Services.) Invoke IDCAMS as follows: 


//STEPO10 EXEC PGM=IDCAMS, REGION=51 2K 

kkk Go eras Some ses es as es mh Sms na fam cn snes tm es ms nm cs nine in Gem em uP as QU ab ins Sa fae cen es Oe es ee om ems 
kA ALLOCATE SPACE FOR SFT-H CLUSTERS USING AMS 
RRR  j§-=— © iain as etait i sen itm i'n sehen: jeanne dons! ih cin Gi eins: nino iiss un 
//SYSTERM DD SYSOUT=* 

//SYSPRINT DD SYSOUT=* 

//SYSIN DD * 


| The following parameters must be specified for any VSAM 
cluster: 


@® CLUSTER--A cluster is being defined. 
@® NAME--The installation-specified cluster name. 


@ CYLINDERS, RECORDS, TRACKS--The amount of space to be 
allocated. 


@ VOLUMES--The volume or volumes to contain the cluster. 
SFT-H requires that you specify the following parameters: 


@ SHAREOPTIONS(2)--The cluster can be opened for input by 
any number of users and for output by only one user. 
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NONINDEXED--Required for the history cluster only; 
indicates an entry sequence cluster (the default is 
INDEXED). 


KEYS (length, offset)--Required for all but the history 
cluster; Table 7-1 contains key values for the SFT-H 
files. 


RECORDSIZE (256 ,32767) --Required for staging files only; 
indicates that the average record size is 256 and that the 
maximum record size is 32,767. If you don't need to stage 
large records, reduce the maximum size specification 
appropriately. This improves the efficiency of VSAM 
access, 


SPANNED -- Required for staging files only; required when 
the maximum record size is larger than the control 
interval size. 


The following parameters are recommended for SFT-H files: 


SPANNED--For the resource master file as well as eres g 
files. 


UNIQUE--A file occupies its own data space on the volume, 
With new IBM catalog systems, this is the only option 
available. 


RECORDSIZE--Use when space is specified with the RECORDS 
parameter; Table 7-1 summarizes the record sizes of the 


CYLINDERS--Recommended for staging files and the 
transmission status file, to improve VSAM access. 


IMBED--To put the index within the data portion of the 
VSAM cluster. Recommended for the transmission status 
file, to improve VSAM access, 


REPLICATE--To put the index on the first track of each 
cylinder the data portion occupies. Recommended for 
staging files and the transmission status file, to improve 
VSAM access. 


NONSPANNED--Recommended for the transmission status file, 
to improve I/O access. 


Table ga Bey Location and Record Size for SFT-H Files 


: | Record Size | Size |; 


Message File INDEXED. 
History File | NON INDEXED 


Resource INDEXED 
Master File | 


Transmission INDEXED 
Control File 


Transmission INDEXED 
Status File 


Staging File INDEXED 


The rest of this subsection contains sample code segments 
that define and create the history file, resource master file, 
transmission control file, transmission status file, and one 
staging file; and allocate the message file. These definitions 
use the 'UNIQUE' option for VSAM file allocation, Since this is 
the stated direction of IBM relative to VSAM files. In all 
examples, replace VOLUMES(VVVVVV) with the name of an appropriate 
volume for your installation. 


Table 7-2 describes the number of records in each SFT-H file. 
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Table 7-2. Size of Records in SFT-H Files 


session + 1 per action in session 


TCF session with LU= 
LU in group for TCF sessions with GROUP= 


Depends on the amount of data transferred 


10 per TCP startup 

per session (each TSF record) 

(approx.) per console operator request 
(approx.) per SFT-6 session attempted 
(approx.) per SFT-6 action within each 
session attempted 

per online interface session 

per online interface command other than 
Display (Change Status, Change Dest., etc.) 
for TCP termination : 
-per staging file opened 

per dynamic file allocation 
additional records per error condition 
detected 


NO Ke O* he OD Ol & & 


Updating the History File 
The following sample code fragment creates the history file: 


/* + + + + + DEFINE HISTORY FILE + +++ + */ 
DEFINE CLUSTER ( - 
NAME (NNNNNNNN,. SNAR1L2.HST. CLUSTER) - 
RECORDS (1000 100) - 
VOLUMES (VVVVVV) - 
NONINDEXED = 
OWNER('HIS') - 
UNIQUE - 
SHAREOPTIONS (2) ~ . 
SPANNED _ ; 
TO(99365) ) - 7" o 
DATA ( | - 
NAME (NNNNNNNN. SNAR12.HST. DATA) - 
RECORDSIZE(194 194) ) 
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Updating the Resource Master File 


The following sample code fragment creates the resource 
master file: 


/* + + + + + DEFINE RESOURCE MASTER FILE + + + + + */ 
DEFINE CLUSTER ( = 
NAME (NNNNNNNN., SNARI1 2. RMF. CLUSTER) _ 
VOLUMES (VVVVVV) a 
FREES PACE (20) ~- 
INDEXED | - 
OWNER('HIS') = 
UNIQUE = 
SHAREOPTIONS (2) - 
SPANNED = 
RECORDS (25 25) - 
TO(99365) ) = 
DATA ( - 
NAME (NNNNNNNN. SNAR1 2. RMF. DATA) - 
RECORDSIZE(24 4034) - 
KEYS(8 0) ) - 
INDEX ( _ 
NAME (NNNNNNNN, SNARL2. RMF. INDEX) ) 


Updating the Transmission Control File 


The following sample code fragment creates the transmission 
control file: 


/* + + + + + DEFINE TRANSMISSION CONTROL FILE + + + + + */ 
DEFINE CLUSTER /( = 
NAME (NNNNNNNN. SNARI1 2. TCF. CLUSTER) - 
VOLUMES ( VVVVVV) = 
FREES PACE (20) - 
INDEXED | - 
OWNER('HIS') = 
UNIQUE - 
SHAREOPTIONS (2) - 
SPANNED - 
RECORDS(100 100) - 
TO0(99365) ) - 
DATA ( _ 
NAME (NNNNNNNN. SNAR12.TCF. DATA) - 
RECORDSIZE(392 392) ~ 
KEYS(19 0Q) ) | - 
INDEX ( ~ 
NAME (NNNNNNNN,. SNARI12.TCF. INDEX) ) 
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Updating the Transmission Status File 


status file: 


/* + + + + + DEFINE TRANSMISSION STATUS FILE + + + + + */ 


DEFINE CLUSTER ( 


NAME (NNNNNNNN,. SNAR1 2. TSF. CLUSTER) 


VOLUMES (VVVVVV) 

FREES PACE (20) 

INDEXED 

IMBED 

REPLICATE 

OWNER('HIS') 

UNIQUE 

SHAREOPT IONS (2) 

NONS PANNED 

CYLINDERS(5 5) 

TO(99365) ) 
DATA ( 

NAME (NNNNNNNN, SNAR12. TSF. DATA) 
RECORDSIZE(342 342) 
CISIZE(2048) 

KEYS(17 0) ) 

INDEX ( | 

NAME (NNNNNNNN. SNAR1 2. TSF. INDEX) 
CISIZE(512) ) 


Updating Staging Files 


The following sample code fragment creates one Staging file: 


/* + + + + + DEFINE A STAGING FILE 


/* 


REFERRED TO WITH DD NAME OF DFLI1 


DEFINE CLUSTER ( 


NAME (NNNNNNNN. SNAR12.DFL1. pCEDETER) 


VOLUMES (VVVVVV) 

FREES PACE (50) 

INDEXED 

OWNER('HIS') 

UNIQUE 

SHAREOPT IONS (2) 

SPANNED 

TO(99365) ) 
DATA ( 

NAME (NNNNNNNN. SNARI1 2.DFL1. DATA) 
CYLINDERS(3 3) 

RECORDSIZE(256 32767) 

KEYS(28 0) ) 

INDEX | a 
NAME (NNNNNNNN. SNAR12.DFL1. INDEX) 


7=12 


+++ + + */ 


(DEFAULT1) 


Sy 


The following sample code fragment creates the transmission 
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The maximum record size allowed is 32767; for efficiency, 
specify a smaller value. Also, VSAM works most efficiently with 
a control-interval size of 4096. If your data records are 
shorter, use a smaller value in the RECORDSIZE parameter. Also, 
use a CI size of 512 for the index component. 


Updating the Message File 


The following sample code fragment allocates the message 
file: 


/* + + + + + DEFINE MESSAGE CLUSTER +++ + + */ 
DEFINE CLUSTER ( _ 
NAME (NNNNNNNN. SNARI 2.MSG. CLUSTER) - 
VOLUMES (VVVVVV) - 
FREES PACE (10) - 
INDEXED - 
OWNER('HIS') ~ 
UNIQUE - 
SHAREOPT IONS ( 2) - 
SPANNED _ 
RECORDS(100 100) oa 
DATA ( _ 
NAME (NNNNNNNN. SNARI1 2.MSG. DATA) - 
RECORDSIZE(144 144) | ~ 
KEYS(5 0) ) - 
INDEX ( _ 

NAME (NNNNNNNN. SNAR1L2.MSG.INDEX) ) 


UPDATING THE SECURITY TABLE 


The online operator interface optionally requires users to 
identify themselves with operator IDS and passwords. The 
security table is used to verify Operator IDs and passwords. 
Use the Honeywell-supplied FTSECURE macro listed in Figure 7-2 
to construct the security table. Assemble FTSECURE before 
invoking the online operator interface. 


7-13 GB88-01 


KEKEKKEKEKKEKEEEERKEKKEKEREKEEKEKREKEREKEKEREREKERREKKEEERKKKKERKEK 


ek kk 
ak FTSECURE: OPERATOR ID AND PASSWORD TABLE xk 
a kk 


KEEKKEEEEKREKEKEEEKEEKERKEKEKEKEKEKEKKEKEKKKEKKKKEKEKKKKKKKKRKKKEK 
* 


* INTERNAL MACRO: 
: ; 
SPACE 2 
MACRO 
FTSECURE &NAME, &PASS, &TYPE=ENTRY 
Fe cece cae ems ee ae ome oe om ws Ow te ow ee ee wo * 
* INLINE MACRO * 
I a es as oe ee ee re ee * 


NAME: FTSECURE 


OPERANDS ; 
TYPE: KEYWORD PARAMETER INDICATING ENTRY TYPE - 
ENTRY GENERATE OPERATOR ID/PASSWORD ENTRY 
END GENERATE END OF TABLE ENTRY 
NAME: POSITIONAL PARAMETER USED WITH TYPE=ENTRY. 
ALL IDS ARE VALID. 
PASS: POSITIONAL PARAMETER USED WITH TYPE=ENTRY. 


ALL PASSWORDS ARE VALID. 


eee Fe He Ee SE HF FH HF HF SH HF SF HF HF FE HF HF HK F 


ARE NOT USED. 


@ 9 e e @ ® e e e e e @ e @ e @ @ e e @ @ e @ e @ e 


AIF ('&TYPE' EQ 'END') . END 
DC CL12'&NAME',CL4'&PASS' 
MEXIT 
» END ANOP 
DC XL16'00' END OF TABLE 
MEND | 
EJ ECT 


Figure 7-2. FTSECURE Macro for Security Table 
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FUNCTION: GENERATE ENTRY IN SFT-H OPERATOR SECURITY TABLE 


1 TO 12 CHARACTER OPERATOR ID. * INDICATES THAT 


1 TO 4 CHARACTER PASSWORD. * INDICATES THAT 


NOTES: ANY NUMBER OF TYPE=ENTRY MACROS CAN BE USED. 
THE FIRST TYPE=END ENTRY TERMINATES THE TABLE. 
IF MORE TYPE=ENTRY MACROS FOLLOW, THOSE ENTRIES 
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KR ERKKK ERE IRK ER IEAI ERR EKER ERE KE ERE RR ERE ER REE REREREEKRR KI 


KREEKKREE | | RKEKKRKRKKKEK 

Rk ARK AE OPERATOR ID AND PASSWORD TABLE RHEKERK KE 

REKKKEKEEE REKKKEKEKK 

KHREKEKKEKEKKEKKEEKEKEKKEEKEKEKEREEREKKEEEKEKEKKEEKEKREKKEEKKEEEKRKKEKKEEKEKEEEE 
SPACE 5 | 

* Fe sens cna came sane cess ins tos au ano ss ten Gm Gt Sm com ces Gh Gnd scan fms A Si en un cD Se ch aes Gm de cum ee * 

FTSECURE CSECT , © * ENTRY POINT FOR FTSECURE TABLE * 

* I a i se ae ss cade la ac de ess ls ns toe es ee * 
SPACE 2 

* Fe cone cae ss coos in tae game tems us ct an ees OID SoD MED ene uP GENS END se GE nnd OND Se GO Senn OD Mn SEND SE SNS Sn * 
FTSECURE *,0000 *ANY ID/PASSWORD OF 0000 * 

* Fe ee se ‘ei a ses isc tcet een SeSei nee men  ih ci te c wa * 
SPACE 2 

k een wieewoces eae eee * 
FTSECURE 999999999999,1111 * ID=NINES, PASSWORD=ONES * 

* Fe ics es ies seta nn a a ae See i is as es ee es ee * 
SPACE 2 

* FC coe cee cee corm sas cane cow fae rn am Sou ca ata cae cess am same mn ns SD ee MS OR We Ma SD com mE em CD END * 
FTSECURE TYPE=END * END OF FTSECURE TABLE * 

* i cae a a a sa in Sei en ee we * 

END 


Figure 7-2 (cont). FTSECURE Macro for Security Table 
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Section 8 
DEFINING AIF TO 
INTERACTIVE SYSTEMS 


This section provides information about the DPS 6 SNA 
Application Interface Facility (AIF) that may be needed by host 
systems programmers and application designers. This section 
discusses how to code the terminal definition statements for the 
Customer Information Control System (CICS) and the Information 
Management System (IMS). 


CICS DEFINITION OF AIF 


This subsection discusses how to code the CICS terminal 
control table generation macro DFHTCT for AIF. Not all the 
DFHTCT operands are discussed--only those that depend on the 
characteristics of the AIF or the way the AIF is configured. See 
the appropriate IBM documentation for a discussion of the other 
aspects of CICS generation. 


The AIF configuration and CICS generation must agree about 
certain characteristics of the AIF devices. Use the 
Configuration Worksheets in the appendix to ensure that the same 
values are given to both. 


Figure 8-1 contains a sample CICS TCT generation (fragment) 
for the AIF. 
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KKK KEKE KEE KEKE EKER EK EKKEKKEEEEEEKEEKEEEEEEEREKEEEKEKEKEKEKEKKRKRKRKKKRKKKK 


x * 
* SAMPLE CICS TCT GENERATION (PARTIAL) FOR DPS 6 SNA . 
* APPLICATION INTERFACE FACILITY * 
* * 


KREKKKEKKKEKEKEEKEKEKKKKKKEKKKKEKKKEKKEEKEEKEKKEKEEKKEKEKRKEKKEKEKEKKEKKKKKKKKKKKEK 
*% 


* DEFINE LU TYPE 0 

* ; 

TCTLUO DFHTCT TYPE=TERMINAL, DEFINE A 3790 DEVICE X 
ACCMETH=VTAM, REQUIRES VTAM SUPPORT X 
NETNAME=TCTLUO , POINT TO LU NAME IN NCP GEN. X 
TRMIDNT=TCTLUO, CICS TERMINAL NAME X 
TRMMODL=2, 1920 CHARACTER SCREEN X 
TRMPRTY=0, EVEN PARITY X 
TRMSTAT=(TRANSCEIVE,NOINTLOG), STARTING STATUS X 
TRMTYPE=3790, SNA 3790 DEVICE X 
TIOAL=1000, | TERMINAL I/O AREA SIZE X 
BUFFER=256, TAKE WHAT APPL. GIVES X 
ERRATT=NO, x 
GMMSG=NO, | X 
RELREQ=(YES,YES) , RELEASE WHEN NOT IN USE x 


SESTYPE=USERPROG 


Figure 8-1. Sample CICS TCT Generation for AIF 
DFHTCT Macro 


The DFHTCT macro defines the characteristics of the AIF to 
the CICS Terminal Control Program. 


The operands that must be coded for the AIF are: 


DFHTCT TYPE=TERMINAL, 
ACCMETH=VTAM, 
NETNAME=luname, 
TRMIDNT=luname, 
TRMMODL=2, 
TRMPRTY=0, 
TRMSTAT= (TRANCEIVE, NOINTLOG) , 
TRMTYPE=3790, 
TIOAL=1000, 
BUFFER=256, 
ERRATT=NO, 
GMMSG=NO, 
RELREQ=(YES, YES) , 
SESTYPE=USERPROG, 


You will probably need other operands, but the following are 
the ones that are most important for the DPS 6. 


ACCMETH=VTAM . AIF supports only VTAM. 
NETNAME=1 uname This name must agree with the name 


assigned to the LU on the ACF/NCP 
LU generation macro. 
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TRMIDNT=1 uname 


TRMMODL=2 


TRMPRTY=0 


This is the CICS terminal name. 
This name must agree with the name 
assigned to the LU on the ACF/NCP 
LU generation macro. 


AIF uses a 1920-character "screen," 


Indicates even parity. 


TRMSTAT= (TRANCEIVE, NOINTLOG) 


TRMTYPE=37 90 
TIOAL=1000 
BUFFER=2 56 
ERRATT=NO 
RELREQ= (YES, YES) 


SESTYPE=USERPROG 


Starting status. 

Indicates a 3790 device. 
Indicates I/O area size. 

AIF uses a buffer size of 256. 
Indicates unattended operation. 
Release required when not in use. 


Indicates session type 
(full-function terminal). 


8-3 : ss GBS 8-01 


IMS DEFINITION OF AIF DEVICES 


This subsection discusses how to code the IMS generation 
macros for AIF. Not all the operands are discussed--only those 
that depend on the characteristics of AIF or the way AIF is 
configured. See the appropriate IBM documentation for a 
discussion of the other aspects of IMS generation. 


The AIF configuration and IMS generation must agree about 
certain characteristics of the AIF. Use the Configuration 
Worksheets in the appendix to ensure that the same values are 
given to both. | | 


Figure 8-2 contains a sample IMS generation (fragment) for 
the AIF. 


KH KKK KEKE KEKE KEKE KEKE KEKE KE KEKE KEKE KEKEEKRKEEKEEKEREKRKEKEK 


* | * 
to SAMPLE IMS TERMINAL DEFINITION (PARTIAL) FOR DPS 6 SNA * 
* APPLICATION INTERFACE FACILITY | * 
* * 


KHEKREKKKEKKKREKRKEKEEKKEKEKEKEKEKEEKKEEKEKEKREKEKREKREKEKKEEKKEKREKERKEKEKKEEKKKEEKEEKKEKS 
te : ; 


TYPE UNITYPE=SLUTYPEP DEFINE DISPLAYS 


* 


TERMINAL NAME=A211 
NAME A211 


TERMINAL A211 


COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 
COMMAND 


Figure 8- 


TYPE Macro 


DISPLAY 
START 
STOP 


DBRECOVERY 


ASSIGN 
DEQUEUE 
EXIT 

HOLD 

IDLE 
PSTOP 
BROADCAST 
CHANGE 


CHECKPOINT | 


LOOPTEST 
PURGE 
SMCOPY 
TRACE 


LU A211 | X 


2. Sample IMS Terminal Definition for AIF 


macro statements. 
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The TYPE macro is the first of a set of terminal description 
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The operands that must be coded for the AIF are: 


TYPE UNITYPE=SLUTYPEP, 


You will probably need other operands, but these are the ones 
that are most important for the DPS 6. 


UNITYPE=SLUTYPEP AIF appears to IMS as one or more 
SNA secondary logical units, 
programmable. 


TERMINAL Macro 


The TERMINAL macro associates the AIF with a VTAM logical 
unit, and defines physical characteristics. 


The operands that must be coded for the AIF are: 


TERMINAL NAME=nodename, 


You will probably need other operands, but the following are 
the ones that are most important for the DPS 6. 


NAME= bystosvonag This name must agree with the name 
luname asSigned to the device on the 
ACF/NCP generation macro. 


NAME Macro 


The NAME macro associates the AIF logical unit with the IMS 
logical terminal definition. 


The operand that must be coded for AIF is: 


NAME log term_name, 


You will probably need other operands, but the following is 
the one that is most important for the DPS 6. 


NAME=log term_name Name of the IMS logical terminal. 


Logical Terminal Definition 


This describes the AIF logical terminal characteristics to 
IMS. 
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The operands that must be coded for AIF are: 


TERMINAL luname 
COMMAND command 


| You will probably need other operands, but the following are 
the ones that are most important for the DPS 6. 


TERMINAL luname Logical-unit name of the AIF 
logical unit. 


COMMAND command Defines characteristics of the AIF 
logical unit. 


8-6 GB88-01 


Section 9 
NCCF AND NPDA 
SUPPORT 


The DPS 6 SNA products support the following types of SNA 
Formatted Maintenance Statistics: 


Type 1: SDLC Test Command/Response Statistics 
Type 2: Summary Error Data 

Type 3: Communications Adapter Error Statistics 
Type 4: PU/LU Dependent Data 

Type 5: Engineering Change Levels. 


The IBM products Network Communications Control Facility 
(NCCF) and Network Problem Determination Application (NPDA) will 
retrieve and display the SNA statistics. 


The NPDA command to get and display the statistics is: 


: LINK 
NPDA CTRL puname )SEC 
DDD 
LVL 
where: 
@ LINK gets and displays type 1 statistics 
® SEC gets and displays types 2 and 3 statistics 
@ DDD gets and displays type 4 statistics 
@ LVL gets and displays type 5 statistics. 
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| and "puname" is the name of the ITF, RJE Facility, SFT-6, or AIF 
physical unit. Alternatively, you can get the same information 
by selecting the specific controller name on certain NPDA 
screens. 


The formats of statistics types 1, 2, and 3 are defined by 
SNA, and all of the products provide them in these formats. 
Specifically, the statistics provided by ITF and the RJE Facility 
are the same as those provided by the IBM devices that they 
emulate. The statistics provided by the SFT-6 are the same as 
those for the RJE Facility. 


When NPDA requests the PU/LU Dependent (type 4) statistics 
from an SNA product, the product sends statistics for its 
physical unit plus statistics for up to seven of the its active 
logical units. NPDA displays the statistics as a block of 
hexadecimal digits. The format of the information sent by the 
SNA products is explained in detail at the end of this section. 


When NPDA requests the Engineering Change Level (type 5) 
statistics from an SNA product, the product sends information on 
the release of the SNA Transport Facility being used and the 
release of the SNA product. NPDA displays the Engineering Change 
Level information as a series of hexadecimal digits. The format 
of the information sent by the SNA products is explained in 
detail in Table 9-1 and 9-2. 


Table 9-1. PU/LU Dependent (Type 4) Statistics 


Contents 


PU Statistics: 

Number of current LU sessions 

Number of ~RSP sent by SNA Transport 

Number of bytes sent by completed sessions 
Number of bytes received by completed sessions 
Time PU statistics were last reset 


LU Statistics for up to 7 LU's:. 
LU identifier 
LU status (always 20 = in session) 
Number of request RUs sent 

Number of request RUS received 
Number of +RSP RUs sent 

Number of -RSP RUs sent 

Number of +RSP RUS received 

Number of -RSP RUs received 
Number of characters sent 

Number of characters received | 
Time LU statistics were last reset 
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Table 9-2. Engineering Change Level (Type 5) Statistics 


Contents 


Configuration file name (in EBCDIC) 


SNA Transport Facility release: 
SNA R1.2 
Reserved 


Program Product Release 
Program product ID ("RJEF", "ITF ","AIF ","SFT ") 
RO1.20 
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Appendix A 
CONFIGURATION 
WORKSHEETS 


This appendix consists of three worksheets to help you 
configure the ITF, the RJE Facility, the SFT-6, and the AIF, Ri 
respectively. The values specified on these worksheets are those 
values that are common to both the host and the DPS 6. Default 


values are underlined. 
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PU 


DPS 6 SNA INTERACTIVE TERMINAL FACILITY 


CHARACTERISTICS 


CONFIGURATION WORKSHEET 


LINE: NON-SWITCHED |_| 


SWITCHED |_| 


XID: 


PU ADDRESS: 


MAXIMUM FRAME (PIU) SIZE: 


MAXIMUM RU SIZE: 


SEND LIMIT: 


CHARACTERISTICS 


LU 


LU ADDRESS: 


LU ADDRESS: 
LU ADDRESS: 
LU ADDRESS: 


LU ADDRESS: 


020 0 


(256, 512, 768, OR 1024) 


(02-33) 


(X'O1'-X'FE') 


256 


LU 


LU 


LU 


LU 


LU 


TYPE: 


TYPE: 
TYPE: 
TYPE: 


TYPE: 


(SWITCHED ONLY) 


(SCS=1 , DISP=2, PTR=3) 
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PU CHARACTERISTICS 


LU 


CHARACTERISTICS 


LINE: 


PU ADDRESS: 


MAXIMUM FRAME (PIU) SIZE: 


XID: 


DPS 6 SNA REMOTE JOB ENTRY FACILITY 


CONFIGURATION WORKSHEET 


NON-SWITCHED |_ 
SWITCHED |_ 


020 


(X'O1'-X'FE') 


MAXIMUM RU SIZE: 


SEND LIMIT: 


LU 


LU 


LU 


LU 


LU 


LU 


ADDRESS: 


ADDRESS: 
ADDRESS: 
ADDRESS: 
ADDRESS: 


ADDRESS: 


(1-6) 


(265 OR 521) 


(256 OR 512) 


RU 


RU 


RU 


RU 


RU 


RU 


~ TDNUM 


SIZE: 


SIZE: 
SIZE: 
SIZE: 
SIZE: 


SIZE: 


(SWITCHED ONLY) 


(256 OR 512) 
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DPS 6 SNA APPLICATION INTERFACE FACILITY 
CONFIGURATION WORKSHEET 


PY CHARACTERISTICS 


LINE: NON-SWITCHED |_| 


SWITCHED | | 
XID: 0200 013 #28... ._. (SWITCHED ONLY) 
IDBLK IDNUM 
PU ADDRESS: ___—s_—s (X01 '-X' FE") 
MAXIMUM FRAME (PIU) SIZE: (265 OR 521) 
MAXIMUM RU SIZE: (256 OR 512) 
SEND LIMIT: 
LU_CHARACTERISTICS 
LU ADDRESS: (1-32) RU SIZE: (256 OR 512) 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS; | RU SIZE; 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: _ RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: | RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
LU ADDRESS: RU SIZE: 
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DPS 6 SNA FILE TRANSFER FACILITY 


CONFIGURATION WORKSHEET 


PU CHARACTERISTICS 


LINE: NON-SWITCHED |_| 


SWITCHED |_| 
XID: 0200 013 +... . (SWITCHED ONLY) 
IDBLK IDNUM 
PU ADDRESS: ___—s_—- (X'01'-X' FE") 
MAXIMUM FRAME (PIU) SIZE: _—s- (265 OR 521) 
MAXIMUM RU SIZE: ss (256 OR 512) 
SEND LIMIT: —__ 
LU CHARACTERISTICS 
LU ADDRESS: ___—_—« (1-6) RU SIZE: ____—— (256 OR 512) 
LU ADDRESS: ____ RU SIZE: —__ 
LU ADDRESS: —__ RU SIZE: | 
LU ADDRESS: ____ RU SIZE: 
LU ADDRESS: ___ RU SIZE: —__ 
LU ADDRESS: ___ RU SIZE: 
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INDEX 


ACF/VTAM Application Program 
Definition for SFT-H, 4-13 


AIF 
(See Application Interface 
Facility) | 


APPL 
Sample APPL Statement for 
SFT-H (Fig), 4-13 


Application Interface Facility 
(AIF) 
CICS Definition, 8-l 
IMS Definition, 8-4 
Sample CICS TCT Generation 


(Fig), 8-2 
Sample IMS Terminal 
Definition (Fig), 8-4 
Application Identifier 
(APPLID) for SFTCP, 4-13 


Block Number, 4-8 
Change Level 
Engineering Change Level 
(Type 5) Statistics (Tbl), 
9-3 


CICS 
(See Customer Information 
Control System) 


Customer Information Control 
System (CICS), 4-14 
Definition of AIF, 8-1 
Definition of ITF Devices, 
5-2 
Sample TCT Generation for 
AIF (Fig), 8-2 
Sample TCT Generation for 
ITF (Fig), 5-5 


Cross Domain Sessions, 4-18 


Default Values Table 
SFT-H Default Values Table, 
4-13 
Supplied With SFT (Fig), 
7-3 
Updating, 7-3 


Device 
CICS Definition of ITF 
Devices, 5-2 
IMS Definition of AIF 
Devices, 8-4 
IMS Definition of ITF 
Devices, 5-6 
DFHTCT Macro, 5-3, 8-2 
Engineering Change Level 
(Type 5) Statistics (Tbl), 
9-3 


Formatted Maintenance 
Statistics, 9-l 


FTSECURE Macro for Security 
Table (Fig), 7-14 


Generation 

Sample CICS TCT Generation 
for AIF (Fig), 8-2 

Sample CICS TCT Generation 
for ITF (Fig), 5-5 

Sample NCP Generation for a 
Nonswitched Line (Fig), 
3-3 

Sample NCP Generation for a 
Switched Line (Fig), 3-5 

VTAM-Only Operands in NCP 
Generation Macros, 4-1 


GROUP Macro, 3-7 


History File, Updating, 7-10 


Host 
DPS 6 Communications With 
IBM Host Processors, 1-l 
How SNA Program Products 
Are Viewed by the Host, 


2-1 
How ITF Appears to the 
Host, 2-1 
How RJE Facility Appears to 
the Host, 2-1 


Tdentification Number, 4-8 
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IMS 
(See Information Management 
System) 


Information Management System 
Definition of AIF Devices, 
8-4 
Definition of ITF Devices, 
5-6 
Sample Terminal Definition 
for AIF (Fig), 8-4 
Sample Terminal Definition 
for ITF (Fig), 5-6 


Installation 
SFT-H Installation Tape, 
7-2 


Interactive Terminal Facility 
(ITF) 

Appears to the Host, 2-1 

CICS Definition of ITF 
Devices, 5-2 

Definition of ITF Devices, 
5-6 

Emulation of IBM 3274-1C 
Terminal Controller, 5-1 

Printers Supported by, 2-1, 
5-1 

Terminals Supported by, 
2-1, 5-1 

Sample CICS TCT Generation 
(Fig), 5-5 

Sample IMS Terminal 
Definition (Fig), 5-6 


ITF 
(See Interactive Terminal 
Facility) 


Job Entry Subsystem 2 (JES2) 
Coding the JES2 RMTnnnn 
Macro, 6-2 


Key | : | | 
Key Location and Record 
Size for SFT-H Files 

(Tbl), 7-9 © 


INDEX 


Keyword 
Pacing-Related Keywords 
(Tb1l), 4-17 
Line 


LINE Macro, 3-8 

PU Macro (For Nonswitched 
Lines), 3-9 

Sample NCP Generation for a 
Nonswitched Line (Fig), 
3-3 

Sample NCP Generation for a 
Switched Line (Fig), 3-5 
Sample VTAM Definition for 
a Switched Line (Fig), 4-5 


Local Address, 3-10, 4-10 


Location, Key 
Key Location and Record 
Size for SFT-H Files 


Logical Terminal Definition, 
8-5 


Logon Mode Table 
Definitions, 4-14 
Sample Entries for DPS 6 
SNA 
Products (Fig), 4-15 


LU 
LU (Switched) Statement, 
4-10 
LU Address, 3-10, 4- ‘10 
LU Macro, 3-10 


LUDRPOOL 
LUPOOL or LUDRPOOL Macro, 
3-6 | 


LU POOL 
LUPOOL or LUDRPOOL Macro, 
3-6 


Macros, List of 
DFHTCT, 5-3, 8-2 
FTSECURE, 7-14 
LU, 3-10 
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Macros, List of (cont) 
LUDRPOOL, 3-6 
NAME, 8-5 
PU, 3-9 
RMTnnnn, 
TERMINAL, 
TYPE, 5-6, 


6-2 
5-7, 
8-4 


8-5 


Maximum Frame Size, 3-9, 4-9 


Maximum Buffer Size, RJE 


MAXSESS Parameter for the 
Transmission Control 
Program, 4-13 
7-13 


Message File, Updating, 


Multimultipoint, 2-3 


Multisystem Networking Feature 
NAME Macro, 8-5 
NCCF 


(See Network Communications 
Control Facility) 


NCP 
(See Network Control 
Program) 


Network Control Program (NCP) 
 NCP=to-LU Pacing, 4-2, 4-11 
Sample Generation for a 
Nonswitched Line (Fig), 

3-3 
Sample Generation for a 
Switched Line (Fig), 3-5 
VTAM-Only Operands in 
Generation Macros, 4-1 


Network Communications Control 
Facility (NCCF), 9-1 


Network Problem Determination 
Application (NPDA), 9-1 


INDEX 


Nonswitched Line 
PU Macro, 3-9 
Sample NCP Generation 
(Fig), 3-3 


NRZI, 3-8 
Pacing, 4-2 
NCP-to-LU, 4-2, 4-11 
Related Keywords (Tbl), 
4-17 
Values, 4-17 
VTAM-to-NCP, 


4-3, 4-12 


Path Information Unit (PIU), 
4-9 


Printer | 
Acting as 3270 Printers, 
5-4 
Acting as SCS Printers, 5-4 
Supported by ITF, 2-1, 5-1 


PU 
PU (Switched) Statement, 
4-8 
PU Macro (For Nonswitched 


Record 
Key Location and Record 
Size for SFT-H Files 
(Tb1l), 7-9 
Size of Records in SFT-H 
Files (Tbl), 7-10 


Resource Master File, 
Updating, 7-11 


Remote Job Entry (RJE) 
Facility 
Emulation of an IBM 3777 
Model 3, 6-1 
Compacted Data, 6-3 
Appears to the Host, 2-1 
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INDEX 


RJ E 
(See Remote Job Entry 
Facility) 
RMTnnnn Macro, 6-2 
Sample 
APPL Statement for SFT-H 
(Fig), 4-13 
CICS TCT Generation for AIF 
(Fig), 8-2 
CICS TCT Generation for ITF 
(Fig), 5-5 
IMS Terminal Definition for 
AIF (Fig), 8-4 
IMS Terminal Definition for 
ITF (Fig), 5-6 
Logon Mode Table Entries 
for DPS 6 SNA Products 
(Fig), 4-15 
NCP Generation for a 
Nonswitched Line (Fig), 
3-3 
NCP Generation for a 
Switched Line (Fig), 3-5 
VTAM Definition for a 
Switched Line (Fig), 4-5 


SCS 
Printers Acting as SCS 
Printers, 5-4 


SDLC Frame, 3-9, 4-9 


Security Table 
FTSECURE Macro (Fig), 7-14 
Updating, 7-13 


SFT 
(See SNA File Transfer 
Facility) 


SNA File Transfer Facility 

ACF/VTAM Application 
Program Definition, 4-13 

Default Values Table, 4-13 

Default Values Table (Fig), 
7-3 

Installation Tape, 7-2 

Key Location and Record 
Size for Files (Tbl), 7-9 


i-4 


SNA File Transfer Facility 
(cont) 

Maximum Number of Sessions, 
4-13 | 

Sample APPL Statement for 
(Fig), 4-13 

Size of Records in Files 
(Tb1l), 7-10 

Updating SFT-H Files, 7-7 


SFT-H 
(See SNA File Transfer 
Facility) 


Staging File, Updating, 7-12 
Station Address, 3-9, 4-8 


Statistic 

Engineering Change Level 
(Type 5) Statistics (Tbl), 
9-3 

Formatted Maintenance 
Statistics, 9-1 

PU/LU Dependent (Type 4) 
Statistics (Tbl), 9-2 

SNA Statistics, 9-1 


Switched Line 
Defining Stations, 4-4 
LU (Switched) Statement, 


4-10 

PU (Switched) Statement, 
4-8 

Sample NCP Generation 
(Fig), 3-5 

Sample VTAM Definition 
(Fig), 4-5 

Table 


Default Values Table 
Supplied With SFT (Fig), 
7-3 

FTSECURE Macro for Security 
Table (Fig), 7-14 

Logon Mode Table 
Definitions, 4-14 

Sample Logon Mode Table 
Entries for DPS 6 SNA 
Products (Fig), 4-15 

SFT-H Default Values Table, 

4-13 
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INDEX 


Table (cont) VTAM 
Updating the Default Values (See Virtual 
Table, 7-3 Telecommunication Access 
Updating the Security Method) 
Table, 7-13 
XID, 4-8 
Tape 
SFT-H Installation Tape, 
7-2 


TCT 
(See Transmission Control 
Table) 


Terminal 

Supported by ITF, 5-1 

ITF Emulation of 
IBM 3274-1C 

Terminal Controller, 5-1 

Logical Terminal 
Definition, 8-5 

Sample IMS Terminal 
Definition for AIF (Fig), 
8-4 

Sample IMS Terminal 
Definition for ITF (Fig), 
5-6 

TERMINAL Macro, 5-7, 8-5 

Supported by ITF, 2-1 


Transmission Control Program 
MAXSESS Parameter, 4-13 


Transmission Control Table 
(TCT) 
Sample CICS TCT Generation 
for AIF (Fig), 8-2 
Sample CICS TCT Generation 
for ITF (Fig), 5-5 


Virtual Telecommunication 
Access Method (VTAM) 
Sample Definition for a 

Switched Line (Fig), 4-5 
VTAM-Only Operands in NCP 
Generation Macros, 4-1 
VTAM~to-NCP Pacing, 4-3, 

4-12 
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